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*ABBREV 


none 

3-12 

♦ADDFILE 

lfn,c 

*AF 

3-5 

♦ADDFILE 

lfn,deck 

*AF 

3-5 

♦BEFORE 

1 

*B 

3-5 

♦CALL 

deck 

*CA 

3-10 

♦CHANGE 

oldid,newid,...,oldid,newid 

*CH 

3-5 

♦COMDECK 

deck 

♦CD 

3-5 

♦COMDECK 

deck,NOPROP 

♦CD 

3-4 

♦COMPILE 

deckl.deck2 

*C 

3-11 

♦COMPILE 

deckl,deck2,....deckn 

*C 

3-10 

♦COPY 

' deck,l 

*CY 

3-6 

♦COPY 

deck,11,12 

*CY 

3-6 

♦COPY 

deck,11,12,lfn 

*CY 

3-6 

♦CWEOR 

level 

*CW 
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♦DECK 

deck 

*DK 

3-5 

♦DECLARE 

deck 

♦DC 
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♦DEFINE 

namel,name2,...,namen 

*DF 
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♦DELETE 

11,12 

*D 

3-7 

♦DELETE 

1 

*D 

3-7 

♦DO 

identl,ident2,...,identn 

none 

3-11 

♦DONT 

identl,ident2,...,identn 

*DT 

3-11 

♦ENDIF 


*EI 

3-11 

♦ENDTEXT 


*ET 

3-12 

♦IDENT 

idname,pl,p2.pn 

♦ID 

3-7 

♦IF 

type,name,num 

none 

3-12 

♦IF 

-type,name,num 

none 

3-12 

♦INSERT 
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*1 

3-7 

♦LIMIT 
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*LT 

3-15 

♦LIST 


*L 

3-14 

♦MOVE 

deckl,deck2 

*M 

3-7 

♦NOABBREV 


*NA 

3-14 
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3-14 
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♦PM 

3-15 

♦PURDECK 

deckl,deck2,...,deckn 
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3-8 

♦PURDECK 

deckl.deck2 

*PD 

3-8 

♦PURGE 

identl,ident2,...,identn 

*P 

3-8 

♦PURGE 

identl.1dent2 

*P 

3-8 

♦PURGE 

ident,* 

*P 

3-8 

♦READ 

lfn 

*RD 

3-13 

♦RESTORE 
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*R 

3-9 

♦RESTORE 
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*R 
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♦REWIND 

lfn 

*RW 
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3-8 

♦SELYANK 

deckl.identl,deck2.ident2,.deckn. identn 

* SY 

3-9 

♦SEQUENCE 

deckl,deck2,...,deckn 

*S 

3-9 

♦SEQUENCE 

deckl.deck2 

*S 

3-9 

♦SKIP 

lfn,n 

*SK 

3-12 

♦TEXT 


*T 

3-14 

♦WEOR 

level 

*W 

3-12 

♦WIDTH 

cardlen.idlen 

*WI 

3-12 

♦YANK 

identl,ident2,...,identn 

*Y 

3-10 

♦YANK 

identl.ident2 

*Y 

3-10 

♦YANKDECK 

deckl,deck2,...,deckn 

♦YD 

3-10 

*/ 

comments 

none 
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PREFACE 


This manual describes the Update utility for maintaining 
and updating decks in compressed symbolic format on 
mass storage. As described in this publication, Update 1.4 
operates under the control of the following operating 
systems: 

NOS 1 for the CONTROL DATA® CYBER 170 Series; 

CYBER 70 Models 71, 72, 73, and 74; and 6000 Series 
Computer Systems 

NOS/BE 1 for the CDC ® CYBER 170 Series; 

CYBER 70 Models 71, 72, 73, and 74; and 6000 Series 
Computer Systems 

SCOPE 2 for the CDC® CYBER 170 Model 176; 

CYBER Mode! 76; and 7600 Computer Systems 

The user is assumed to be familiar with the operating 
system and computer system in use. 

The following manuals are of primary interest: 

Publication 

Publication Number 

NOS Version 1 Reference Manual, Volume 1 of 2 60436400 

NOS/BE Version 1 Reference Manual 60493800 

SCOPE Version 2 Reference Manual 60342600 

The following manuals are of secondary interest: 

Publication 


Publication Number 

NOS Version 1 Manual Abstracts 84000420 

NOS Version 1 Reference Manual, Volume 2 of 2 60445300 

NOS/BE Version 1 Manual Abstracts 84000470 

Software Publications Release History 60481000 


CDC manuals can be ordered from Control Data Corporation, Literature and 
Distribution Services, 308 North Dale Street, St. Paul, Minnesota 55103. 


The users of Update can find additional pertinent 
information in the Control Data Corporation manuals. 
The manuals are listed alphabetically within groupings 
that indicate relative importance to readers of this 
manual. 

The NOS Manual Abstracts and the NOS/BE Manual 
Abstracts are pocket-sized manuals containing brief 
descriptions of the contents and intended audience of NOS 
and NOS/BE and all the product set manuals of these two 
operating systems. The abstracts manuals can be useful in 
determining which manuals are of greatest interest to a 
particular user. The Software Publications Release 
History serves as a guide in determining which revision 
level of software documentation corresponds to the 
Programming System Report (PSR) level of installed site 
software. Manuals of interest are listed below. 


This product is intended for use only as described in 
this document. Control Data cannot be responsible 
for the proper functioning of undescribed features or 
parameters. 
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INTRODUCTION 


1 


Update is a utility for maintaining and manipulating a mass 
storage file containing images of coded punched cards or 
text lines. Once these images have been made a part of an 
Update program library, physical punched cards or lines can 
be eliminated. Update can maintain 6-bit (display code) 
line images and 8-bit (ASCII) line images on the same 
program library. Line images can be as long as 256 
characters. The length of line images written to the 
compile file can be controlled by the Update features. The 
entire line appears in the output listing. 

A file of line images to be manipulated by Update must be 
in a special format known as a program library. Three 
types of Update runs generate or manipulate a program 
library: 

• A creation run generates a program library from the 
input stream text. 

• A correction run manipulates the contents of an 
existing program library. 

• A copy run changes the format of a program library 
from random to sequential or from sequential to 
random. 

A separate new program library can be created with a 
correction run; the changes made during the correction run 
are permanently recorded in the new program library. 

As each line image is written to the program library, 
Update assigns it a unique identifier. 

Groups of line images within the program library are known 
as decks. Each program library must have at least one 
deck, with the maximum number of decks being 262143. 
Deck grouping is significant in terms of extracting line 
images from the program library in a format suitable for 
use by a compiler, assembler, or print routine. While an 
individual card can be referenced for purposes such as 
deletion of that card or insertion after that card, the 
smallest unit that can be extracted from the proqram 
library is the deck. Program libraries can be maintained in 
the display code or ASCII character set. All ASCII input or 
output codes are 8-bit characters, right-justified in a 12-bit 
byte (ASCII 8/12). 

Typically, use of Update involves maintenance of a group 
of compiler or assembly language routines. For 
convenience, the programmer often specifies each routine 
or group of related routines as an individual deck. One 
routine can then be changed or extracted without affectinq 
other routines in the program library. Because each card 
image in a deck has its own identifier (a deck name) and an 
Update-supplied sequence number, the line image can be 
referenced individually in order to correct or change a 
routine. Then, the deck containing the modified routine 
can be extracted from the program library and used as if it 
had been entered into the system as a punched deck. 

A deck can be composed of punched cards or images of 
punched cards. Update makes no assumptions about 
contents. While programs are the usual contents 
maintained by Update, this utility is equally applicable to a 
set of data cards or any other text. 


The programmer controls Update operations through the 
following two mechanisms: 

• The UPDATE control statement parameters specify 
the general operations to be performed. The 
parameters control the files to be manipulated and 
influence the type of operations performed. 

• The input stream card images specify the detailed 
operations to be performed and specify the card 
images to be made a part of the program library. The 
instructions for Update operation are called directives; 
the card images for the program library are called 
text. The input stream can be either part of the job 
deck containing the UPDATE control statement or a 
separate file. 

Files used or generated by Update have generic names that 
are related to their default logical file names. The 
following names are used in the remainder of this manual in 
describing Update operations: 

» Input file - the user-supplied file or part of the job 
deck that contains the input stream of Update 
directives and text. 

• Output file - the listing file generated by Update that 
contains the status information produced during 
Update execution. It is in a format suitable for 
printing. 

• Program library - the file generated by an Update 
creation run that contains the decks of card images. 
When the file is created, it is known as the new 
program library. When the file is corrected, it is 
known as the old program library. Card images in the 
program library are in a format that can be 
manipulated by Update, but the format is meaningless 
to most other formats and utilities. 

• Compile file - the file generated by Update that 
contains card images restored to a format that is 
acceptable to a compiler or assembler. Decks written 
to the compile file during any given run are controlled 
by the Update mode selected, by control statement 
parameters, and by directives in the input stream. 

• Source file - the file generated by Update that 
contains card images of an input stream that would 
allow regeneration of the program library. 

Section 2 contains a detailed discussion of the files used or 
generated by Update. 

The directives for Update are interspersed with text in the 
input stream. They are distinguished by the presence of a 
control character contiguous with a directive keyword. 
More than 40 directives exist. The directives can be 
grouped according to the following operations: 

• Identify decks. 

• Control compile file contents. 

• Manipulate primary or secondary input streams. 
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• Control overall handlinq of input files. 

• Modify program library contents. 

Section 3 contains a detailed discussion of Update 
directives. 

CREATION RUN 

A creation run constructs a program library. It is the 
original transfer of punched cards or line images into 
Update format. The input file of a creation run can consist 
of ASCII 8/12 or display code characters. ASCII characters 
must be right-justified in 12-bit bytes. The new program 
library is created in ASCII, if the input file uses ASCII and 
the N8 parameter is specified on the UPDATE control 
statement. 

A creation run exists when the first card read from the 
input stream is a DECK or COMDECK directive. A 
creation run also exists when one or more of the following 
ten directives precedes the first DECK or COMDECK 


directive: 



ABBREV 

NOABBREV 

REWIND 

DECLARE 

NOLIST 

SKIP 

LIMIT 

READ 

/(comment) 

LIST 




The presence of any other directive before the first DECK 
or COMDECK directive causes Update to consider the run 
to be a correction run. 

In addition to the preceding directives, the following are 
the only Update directives that can be used during a 


creation run: 





CALL 

END 

ENDTEXT 

TEXT 

WIDTH 

CWEOR 

END IF 

F 

WEOR 



Each DECK or COMDECK directive defines a deck to be 
inserted into the program library that is being created. All 
text and directives following a DECK or COMDECK 
directive, until the next DECK or COMDECK directive, are 
considered to be part of the deck. Each card image 
receives the deck name and a unique sequence number so 
that the images can be referenced individually. The DECK 
or COMDECK directive defining the deck itself is assigned 
the sequence number one. 

Update decks can be one of two types: a regular deck 
declared with a DECK directive, or a common deck 
declared with a COMDECK directive. DECK and 
COMDECK differ in that a common deck can be called by 
name so that it is inserted into the text of another deck 
when the compile file is being generated. One copy of the 
common deck exists on storage, but multiple copies can be 
part of a compile file. 

When the library is created, Update generates a deck 
named YANK$$$ as the first deck on the library. The 
YANK$$$ deck contains all the YANK, SELYANK, 
YANKDECK and DEFINE directives that are encountered 
during Update runs. (The YANK$$$ deck is described 
further in appendix D, File Format and Structure.) Update 


also generates a deck list and directory during a creation 
run. The deck list contains the names of all decks in the 
library and the location of the first word for each deck 
(random library) or the relative order of the decks 
(sequential library). The directory contains one entry for 
each DECK, COMDECK, and IDENT directive that is used 
for the library. 

CORRECTION RUN 

A correction run, which is the most common use of Update, 
introduces changes into the existing program library. 
These changes exist only for the duration of the run unless 
a new program library is generated. Update recognizes a 
correction run when it encounters a directive other than 
one of the ten creation run directives prior to encountering 
DECK or COMDECK. 

A correction run consists of a read-input-stream phase and 
a correction phase. During the first phase, Update reads 
directives and text, adds any new decks, and constructs a 
table of requested correction operations. During the 
second phase, Update performs the requested modifications 
on a deck-by-deck basis. 

The input file of a correction run can be in ASCII 8/12 or 
display code characters. Update uses ASCII for the 
program library, if the character set of the old program 
library uses ASCII and the N8 parameter is on the UPDATE 
control statement. 

The corrections to the library (the newly inserted cards, 
replaced cards, and deleted cards) make up the correction 
sets. The IDENT directive assigns a unique identifier to 
each card image inserted by the correction directives. 
Each inserted card image is assigned a sequence number 
beginning with one for each IDENT name. All card images 
having the same correction set identifier comprise a 
correction set. 

Update permits a user to remove (yank) the effects of a 
correction set or deck and later restore the correction set 
or deck. This feature is convenient for testing new code. 
Requests for yanking are maintained in the YANK$$$ 
deck. Before obeying a correction, Update checks the 
correction identifier against the YANK$$$ deck to see if 
the correction has already been yanked. If the correction 
has been yanked, an informative message is issued and 
processing continues. This effect on the YANK$$$ deck 
can be selectively controlled through DO and DONT 
directives within the decks. 

The image of a card, even though deleted through DELETE 
or yanking, is maintained permanently on the program 
library with its current status (active or inactive) and a 
chronological history of modifications to its status. The 
images contain information known as correction history 
bytes. The history bytes that are generated by Update 
contain the history and status of the card and enable 
Update to reverse status. Deletion of a card, for example, 
is accomplished by the addition of a correction history byte 
to the card image rather than a physical deletion of the 
image. Consequently, the card can be reactivated at some 
later time. 

Update also allows a complete and irreversible purging of 
correction sets and decks. When a correction set or deck is 
purged, it is physically removed from the library. 
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COPY RUN 

A copy run changes the old program library format from 
sequential to random or from random to sequential. 
Update recognizes a copy run when either the A or Q 
parameter is specified on the UPDATE control statement. 
Since Update does not read the input file on a copy run, no 
other operations are performed. The control statements 
COPY, COPYBF, COPYCF, COPYBR, or COPYCR should 
not be used on random access files since the operating 
system might not recognize that the copied file is a random 
access file. 

DECK LIST AND DIRECTORY ORDER 

Update maintains a deck list and directory for its internal 
use. The deck list and directory are only significant to the 
user when ranges of decks or correction sets are specified 
on Update directives. The output file (O parameter) lists 
the order of the deck names and correction set identifiers. 
The deck list and directory are always maintained in 
display code. 

The deck list contains a list of all decks in the program 
library. The original entries of the deck list correspond to 
the order of the decks when written during the creation 
run. Subsequent entries are added to the end of the list as 
they are introduced in the program library. Therefore, 
deck list order might not reflect actual deck order in the 
program library, since the user determines deck location 
within the program library through directives. 

The location of an entry in the deck list is significant in 
terms of parameters for PURDECK, SEQUENCE, and 
COMPILE directives in which a range of decks can be 
referenced. The order of names in a range reference must 
be the same as the order in the deck list. The decks named 
and all the decks between are then processed in accordance 
with the directive. An error exists if they are in reverse 
order. 

Similarly, as each deck and correction set is introduced 
into the program library, Update creates an entry in an 
internal directory in chronoloqical sequence. The location 
of an entry in the directory is significant in terms of 
parameters for PURGE and YANK directives in which a 
range of correction sets can be referenced. The order of 
reference must be the same as the order of the directory. 
The identified correction sets and all the sets between are 
processed in accordance with the directive. An error exists 
when a correction set ranqe is not referenced in the order 
the sets were introduced into the library. 


UPDATE MODE 

The content of any compile file, source file, or new 
program library produced during a correction run is 
affected by the Update mode. (Table 2-2 summarizes the 
effect of mode upon file content.) The mode of an Update 
run is determined by a combination of the omission or 
specification of the F and Q parameters on the Update 
control statement as summarized in table 1-1. 


TABLE 1-1. UPDATE MODE 


Parameter 

Mode 

F specified 

Full mode in which all decks 
on the old program library are 
processed. 

Q specified 

Quick mode in which only decks 
specified on COMPILE directives 
and decks added through ADDFILE 
directives are processed. 

Both c and 

0 specified 

Quick mode. 

Both F and 

Q omitted 

Normal selective mode in which 
the only decks processed are 
those modified or those specified 
on COMPILE directives. 


The mode chosen depends on how extensively the user 
wishes to modify the program library and its size. If the 
library contains many decks and the user wishes to modify 
only a few decks, quick mode should be used. If there are 
many decks and the user wants all decks to be processed, 
full mode should be used. Normal selective mode should be 
used when only those decks modified or specified are 
wanted in the compile file. 
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UPDATE FILES 
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During its execution, Update manipulates as many as eight 
files that can be referenced by the user. The files involved 
with any given run depend on the following: 

• The parameters selected by the UPDATE control 
statement. 

• Whether the run is a creation run, correction run, or 
copy run. 

The files that Update generates or uses are described 
below. Each of these files has a default name, but other 
names can be specified through the appropriate parameters 
on the UPDATE control statement. 

File characteristics are summarized in table 2-1. The 
ASCII chracter set codes used in a file are 8-bit characters 
right-justified, in 12-bit bytes. 

Whether or not a file is optional, used, or not applicable on 
an Update run depends on the type of run, as follows: 


• Creation run - the user must supply the input file. 
Update generates the new program library, compile 
file, and output file by default. The generation of a 
source file is optional. No other files are applicable on 
a creation run. 

• Correction run - the user must supply the input file, 
the old program library, and the merge file (if a merge 
is to take place). Update generates, by default, the 
output and compile files. The creation of a new 
program library, source file, and pullmod file is 
optional on a correction run. 

• Copy run - the user must supply the old program 
library. Update generates, by default, the new 
program library and the output listing file. No other 
files are applicable on a copy run and, if specified, are 
ignored. 


TABLE 2-1. FILE SUMMARY 


File 

Default 

Name 

Contents 

Mode 

Default Position 

Input 

INPUT 

The input stream. 

Binary 

Remains at the end 
of the record (end- 
of-section for 

SCOPE 2) terminating 
Update directives. 

If Update aborts, 
location of input 
file is unpredict¬ 
able. 

New program library 

NEWPL 

Updated library. 

Binary 

Rewound before and 
after run. 

Old program library 

OLDPl 

Library to be updated. 

Binary 

Rewound before and 
after run. 

Secondary old 
program library 

None 

Library from which common decks 
can be called. 

Binary 

Rewinding not 
necessary because 
file must be 
random. 

Compile 

COMPILE 

Line images for assembly or 
compilation. 

Binary 

Rewound before and 
after run. 

Output 

OUTPUT 

Information for the programmer. 

8inary 

Remains in current 
position. File is 
not rewound. 

Source 

SOURCE 

Consists of line images that 
would allow regeneration of a 
new program library. 

Binary 

Rewound before and 
after run. 

Merge 

MERGE 

Second library to be merged 
into new program library. 

Binary 

Rewound before and 
after run. 

Pullmod 

Source 

file 

Re-created correction sets. 

Binary 

Rewound before and 
after run. 
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The contents of any compile file, source file, or new 
program library produced during a run are affected by the 
Update mode and the file format of the old program 
library. The contents of these files are summarized in 
table 2-2. 

INPUT FILE 

The input file contains the input stream; it must contain 
coded cards or their equivalent. The input stream consists 
of directives that direct Update processing and text to be 
added to the program library. The directives allowed in the 
input stream are determined by the type of Update run. 
| The input data can be equal to or less than 256 characters. 

Update initially reads the input stream from the primary 
input file specified by the 1 parameter of the UPDATE 
control statement; default file name is INPUT. Update 
stops reading directives and text when it encounters a 
7/8/9 card or its equivalent, or end-of-information (EOl). 

If Update encounters a READ or ADDFILE directive in the 
input stream, it stops reading from the primary input file 
and starts reading from the file specified on the directive. 
Update reads one system-logical record (one section for 
SCOPE2) from the secondary input file, then resumes 
reading from the primary input file. 

The input file con consist of ASCII 0/12 or display code 
characters during a creation or correction run. Update 
uses ASCII for the program library if the character set of 
the old program library uses ASCII and if the N8 parameter 


is on the UPDATE control statement. The input file 
character set is determined from the first line of the input 
file. If other than ASCII 8/12 character set data is 
entered, the invalid code is translated into a blank. See 
appendix A for the character set tables. 

PROGRAM LIBRARY FILES 

A program library is created during an Update run and can 
be manipulated in later runs. The library consists of a file 
of card images and internal information in a special format 
that can be processed only by Update. The card images are 
grouped into decks. Each card image is represented in a 
compressed format with multiple space characters removed 
that adds a card identifier. The format also includes 
history and status information that is known as correction 
history bytes. Program libraries can be maintained in 
display code or ASCII code characters. 

The program library also contains a deck list and a 
directory. The deck list contains the names of all decks in 
the library. In addition to deck names, the directory also 
contains the names of all correction sets. Unless changed 
by the E parameter of the UPDATE control statement, the 
names in both the deck list and the directory exist in the 
order they were introduced. 

Update can create and maintain program library files in 
two distinct formats: random and sequential. (These 
formats are described in detail in appendix D.) A random 
program library can be processed substantially faster than 
a sequential program library; however it can exist only on 
disk and not on tape. 


TABLE 2-2. FILE CONTENTS AND UPDATE MODE 


File 

Normal Mode 

Contents 

Full Mode 

Contents 

Quick Mode Contents 
(Sequential OLDPL) 

Quick Mode Contents 
(Random OLDPL) 

New 

Program 

Library 

Regular decks and 
common decks after 
corrections are made. 

Regular decks and 
common decks after 
corrections are made. 

All decks specified 
on COMPILE directives, 
any common decks they 
call, and any common 
decks encountered 
prior to al1 decks of 
COMPILE. 

Decks specified on 
COMPILE directives 
and any common decks 
they call. 

Compile 

File 

Decks corrected or 
on COMPILE direc¬ 
tives and decks 
calling a corrected 
common deck (unless 
the calling deck 
precedes the common 
deck or NOPROP is 
specified on 

COMDECK). 

Active decks on old 
program library. 

Decks on COMPILE 
directives and decks 
added via ADOFILE 
plus called common 
decks. 

Decks on COMPILE 
directives and decks 
added via ADDFILE 
plus called common 
decks. 

Source 

File 

Active lines and 
deck required to 
re-create the 
the library. 

Active lines and 
decks required to 
re-create the 
library. 

Active lines from 
decks specified on 
COMPILE directives, 
any common decks 
they call, and any 
common decks encount¬ 
ered prior to all 
decks on COMPILE. 

Active lines from 
decks specified 
on COMPILE directives 
and any common decks 
they call. A common 
deck called by a 
deleted* CALL 
directive. 
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NEW PROGRAM LIBRARY 

A new program library is initially generated on a creation 
run. It contains directives and text in an updatable 
format. File content is determined by the file format of 
the old program library and Update mode as shown in 
table 2-2. The new program library name is specified by 
the N parameter of the UPDATE control statement; the 
default file name is NEWPL. The new program library 
character set is the same as the character set used in the 
input file during the creation run. 

For subsequent correction runs, the previously generated 
new program library is identified as the old program 
library. A new program library that incorporates the 

changes made during the correction run is generated if 
requested. 

A new program library can be in random or sequential 
format. In the absence of the W parameter on the 

UPDATE control statement, the format is determined by 
file residence and record type as shown in table 2-3. 


TABLE 2-3. NEW PROGRAM LIBRARY FORMAT 


Format 

NOS and NOS/BE 

SCOPE 2 

Random 

File is on mass 

File is on mass 


storaqe and W 

storaqe, record 


is not 

tvpe is W un- 


selected. 

blocked, and W 
is not 
selected. 

Sequential 

Fife is on maq- 

File is staged 


netic tape or W 

or online 


is selected. 

tape; or is on 
mass storage as 
record tvpe S 
or record tvpe 

W blocked; or W 
is selected, or 

R specifies no 
rewind. 


A new program library can be written or appended to an 
existing permanent file according to the permission rules of 
NOS, NOS/BE, or SCOPE 2. 


OLD PROGRAM LIBRARY 

The old program library is the file that was generated as a 
new program library in a previous run. It contains a record 
of changes made since the program library was created. 
The old program library name is specified by the P 
parameter of the UPDATE control statement; the default 
file name is OLDPL. 

An old program library is required for a correction run 
since it is the program library to be updated. On a copy 
run, the old program library is not modified, but is copied 
to a sequential or random new program library. If an old 
program library is specified on a creation run, it is ignored. 

In addition to the old program library to be updated, up to 
seven additional (secondary) old program libraries can be 
specified by the P parameter of the UPDATE control 
statement. Decks on the old program library can call 


common decks from the old program library or from any of 
the other secondary program libraries. No Update 
directive other than CALL can be used to reference 
common decks on secondary old program libraries. 
Common decks on secondary old program libraries can call 
common decks that reside on any of the old program 
libraries. Program libraries are searched in the order 
specified to find the called common decks. The called 
common decks that reside on the secondary old program 
libraries are not added to a new program library. 

The secondary old program libraries must be random, have 
a unigue name, and have the same master control character 
as the old program library. If these conditions are not met, 
a diagnostic message is issued. 

When creating a new program library on a creation run that 
contains calls to common decks that reside on secondary 
old program libraries, C=0 must be specified on the 
UPDATE control statement. 

COMPILE FILE 

The compile file contains copies of decks in the program 
library restored to a format that can be processed by a 
compiler or assembler. The decks written to the file are 
determined by Update mode and the file format of the old 
program library as shown in table 2-2. Through the control 
statement parameters D and 8, the user can specify 
whether the text on the file is to have Update card 
identifiers on each line of text. 

Compile file name is specified by the C or K parameter of 
the UPDATE control statement; default file name is 
COMPILE. If the K parameter is specified, then decks are 
written to the compile file in the order they appear on 
COMPILE directives. (Any decks not specified on 
COMPILE directives follow those specified.) If the C 
parameter is specified, then decks are written on the 
compile file in the order they appear in the deck list. 

The user has control over the decks written to the compile 
file through the compile file directives. Common decks 
can be called conditionally or unconditionally according to 
compile file directives embedded in the program library 
decks. Additional control of compile file format is 
afforded the user through directives that cause a 
system-logical record (end-of-section for SCOPE 2) of the | 
specified level to be written at the end of decks. The 
compile file directives can be in the original decks or can 
be inserted into the program library decks during 
correction runs. These directives are interpreted when the 
compile file is written; the directives are not written on 
the compile file. 

LISTABLE OUTPUT FILE 

The listable output file is the print file containing 
information for use by the programmer. Content of the 
file is controlled by the L parameter of the UPDATE 
control statement with options that can select a listing of 
directives processed, errors, comments, and a list of card 
imaqes in the program library. The locations of all 
CWEOR, WEOR, ENDIF, IF, and CALL directives are listed 
if a compile file is written. If L=0, all listable output is 
suppressed. Output file name is specified by the O 
parameter of the UPDATE control statement; default file 
name is OUTPUT. 
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In quick mode only, Update produces an ordered printout of 
the deck list of the program library under the heading 
DECK LIST AS READ FROM OLDPL PLUS ADDED NEW 
DECKS. A quick mode dummy Update run (no decks added) 
produces a deck listing of the old program library. 

The output file always defaults to display code characters 
unless the 08 option is specified. 

SOURCE FILE 

The source file is an optional file generated during a 
correction or creation run. The source file consists of the 
card images of an input stream that would allow generation 
of a new program library with only currently active card 
images in resequenced format during a subsequent creation 
run. Only active DECK, COMDECK, WEOR, CWEOR, 
WIDTH, CALL, TEXT, IF, ENDF, and ENDTEXT 
directives, in addition to all active text, are part of the 
source file. The card images in the source file do not 
contain card identifiers. 

The source file name is specified by the S parameter of the 
UPDATE control statement; default file name is SOURCE. 
The content of the file is determined by the T parameter of 
the UPDATE control statement and by Update mode and 
the file format of the old program library as shown in 
table 2-2. The user is responsible for routing the source 
file to a punch or other output device. 

If the old program library consists of ASCII code 
characters, the source file can consist of display or ASCII 
code characters. 

MERGE FILE 

The merge file contains a program library to be merged 
with the old program library into a new program library. 
Update adds the deck list and directory from the merge file 
to the deck list and directory on the old program library. 
Any names on the merge file that duplicate names on the 
old program library are modified to make them unique as 
foil ows: 


• The last character of the name is changed by adding 01 
(modulo 55g) until all valid characters have been tried. 

• A character is appended to the name and the first step 
is repeated. Characters are appended until the name 
reaches nine characters. 

If no unique name can be generated by this method, the 
Update run is abnormally terminated. Directives that 
reference these changed names are modified to agree with 
the new name. All names that required modification are 
listed in the output file. 

Merge file name is specified by the M parameter of the 
UPDATE control statement; default name is MERGE. All 
Update functions that are valid in a correction run are 
valid with the merge parameter. Care should be exercised 
when including modifications in a merge run. Update might 
change a name to which correction cards have been 
applied. In this case, corrections can refer to the wrong 
deck or correction set. 

Decks from the merge file are added to the new program 
library after all decks from the old program library are 
added. This sequence of decks in the new program library 
can be altered by the MOVE directive if desired. 

PULLMOD FILE 

The pullmod file contains directives and text of re-created 
correction sets specified on PULLMOD directives. These 
re-created correction sets produce the same results as the 
original sets. This feature permits a user to take an earlier 
version of the library and apply selected correction sets. 
The file has the same format as an input file. 

File name is specified by the G parameter of the UPDATE 
control statement. If no file is specified, pulled 
modifications are written to the source file specified by 
the S or T parameter; if no source file is specified, the 
re-created correction sets are written to a file named 
SOURCE. 
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Directives allow the user to create program libraries. 
Directives also extensively control and direct the 
correction and modification process. Directives perform 
the following operations: 

• Identify decks. 

• Control compile file contents. 

» Manipulate primary or secondary input streams. 

• Control overall handling of the input file. 


Since Update scans all 256 columns when interpreting | 
directives, comments or sequencing information from a 
previous run can be interpreted as the parameter list. 
Update interprets comments or sequencing information as 
the parameter list when a list is not specified on WEOR, 
CWEOR, DECLARE, or ADDFILE directives. To avoid this 
problem, a null parameter list should be specified on these 
directives in the following manner: 

♦WEOR,, *DECLARE„ 

♦CWEOR,, *ADDFILE,„ 


• Modify program library contents 
Each directive is summarized in table 3-1. 


DRECTIVE FORMAT 


Specifying a null parameter field ensures that Update will 
use the default values as parameters rather than using the 
comments or sequencing information. Errors will occur if 
Update tries to use the comment or sequencing information 
as the directive parameter list. 


The general format of Update directives is shown in 
figure 3-1. A directive must begin with the master control 
character in column one. Comments can be placed after 
the last parameter of the directive. The comment and 
final parameter must be separated by one or more blanks. 
Most directives have both a full keyword and an 
abbreviated keyword as shown in table 3-1; when the 
NOABBREV directive is in effect, Update does not 
recognize the abbreviated forms of directive names. Any 
card in the input stream that cannot be recognized as a 
directive is assumed to be text. 


'keyword p-list 

* Master control character that distinguishes a 

directive from a text cerd. Must eppear In 
column 1. This character can be changed 
through the * parameter of the UPDATE 
control statement. 

keyword Name of one of the Update directives or an 
abbreviation for a directive. No blanks can 
occur between the master control character and 
the keyword; a comma or blank terminates the 
keyword. 

p-list Parameters identifying decks, cards, or files. 

Some directives have no parameters. Multiple 
blanks can appear between the keyword and 
parameters. Parameters in the list are separated 
by commas; embedded blanks cannot appear in 
the list. A blank terminates the p-list. 

Notice that several parameters contain a period 
as part of a single parameter. 


Figure 3-1. General Update Directive Format 


The master control chracter is recorded in the program 
library. For a correction run, the master control character 
should match the character used when the program library 
was created. If the characters do not match, Update uses 
the character specified in the program library. 


LINE DENTIFIERS 

Each card image in a program library is uniquely identified 
by an identifier and a sequence number. The identifier is 
the name of the deck or correction set from which the card 
image originated; Update supplies the sequence number. 
Card identifiers assigned by Update are usually permanent; 
they can be changed only through the use of the 
SEQUENCE and CHANGE directives. 

Update recognizes one full form and two short forms of 
card identifiers. The full form card identifiers are shown 
in fiqure 3-2. The two short forms of card identifiers, 
which can be used on BEFORE, INSERT, DELETE, 
RESTORE, and COPY directives, are expanded. 


■dent.seqnum 

ident. 1- through 9-character name of a correction 
set or deck. A period terminates the 
identifier. 

seqnum Decimal ordinal (1 through 131071) repre¬ 
senting the sequence number of the card 
within the correction set or deck. Any char¬ 
acter other than 0 through 9 terminates the 
sequence number. 


Figure 3-2. Full Form of Card Identification 


In the short form (shown in fiqure 3-3), idname is assumed 
to be the last explicitly named identifier given on a 
BEFORE, INSERT, DELETE, RESTORE, or COPY 
directive, whether or not it is a deck name. The dname is 
assumed to be the last explicitly named identifier given on 
a BEFORE, INSERT, DELETE, RESTORE, or COPY 
directive that is known to be a deck name. Both of these 
default identifiers are originally set to YANK$$$; 
therefore, the first directive using a card identifier must 
use the full form to reset the default. 
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TABLE 3-1. SUWARY OF UPDATE DIRECTIVES 


Directive Keyword 
Abbreviation 

Directive Format 

Use 

none 

♦ABBREV 

Resume checking for abbreviated directives. 

*AF 

♦ADDFILE Ifn,name 

Read creation directives and text from 
named file and insert after specified deck 
or line. 

*B 

♦BEFORE 1 

Write subsequent text lines before line 
identified. 

*CA 

♦CALL deck 

Write common deck to compile file. 

*CH 

♦CHANGE oldid.newid, . . . ,oldid,newid 

Change correction set identifier. 

*CD 

♦COMDECK deck,NOPROP 

Define common deck and propagation 
parameter. 

*C 

♦COMPILE deckl,deck2, . . . ,deckn 

Write specified decks to compile file, 
source file, and new program library. 


♦COMPILE deckl.deck2 

Write inclusive range of decks to compile 
file, source file, and new program library. 

*CY 

♦COPY deck,! 

Copy and insert specified line from named 
deck. 


♦COPY deck,11,12 

Copy and insert specified range of lines 
from named deck. 


♦COPY deck,11,12,1fn 

Copy specified range of cards from named 
deck to specified file. 

*CW 

♦CWEOR level 

Conditionally write end-of-record (end-of- 
section for SCOPE 2) or end-of-file. 

*DK 

♦DECK deck 

Define deck to be included in program 
library. 

*DC 

♦DECLARE deck 

Restrict corrections to named deck. 

*DF 

♦DEFINE namel,name2, . . . ,namen 

Define names to be tested by IF directive 
while compile file is being written. 

*D 

♦DELETE 1 

Deactivate specified line and optionally in¬ 
sert text in its place. 


♦DELETE 11,12 

Deactivate inclusive range of lines and 
optionally insert text in their place. 

none 

♦DO identl,ident2, . . . ,identn 

Reactivate yanked cards in specified 
correction sets until a DONT is encountered. 

*DT 

♦DONT identl,ident2, . . . ,identn 

Terminate the DO for specified correction 
sets. 

*EI 

♦ENDIF 

Indicate end of conditional text. 

*ET 

ENDTEXT 

End delimiter for sequence of lines 
identifying text. 

*ID 

♦IDENT idname,B=num,K-ident,U=ident 

Define correction set, bias for seqnum, and 
whether specified correction sets must be 
known or unknown to process this set. 

none 

♦IF type,name,num 

Write specified number of following lines to 
the compile file if name of type DECK, IDENT, 
or DEF is known. 
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TA8LE 3-1. SUMMARY OF UPDATE DIRECTIVES (Contd) 


Directive Keyword 
Abbreviation 


Directive Format 


Use 


♦IF -type,name,num 

♦I *INSERT 1 

♦IT *LIMIT n 

*L *LIST 

*M *M0VE deckl,deck2 

*NA *NOABBREV 

*NL *N0LIST 

*PM *PULLM0D 1dentl,1dent2, . . . .identn 

*PD *PURDECK deckl,deck2.deckn 

♦PURDECK. deckl.deck2 

*P *PURGE identl,ident2, . . . ,identn 

♦PURGE identl.ident2 

♦PURGE ident,* 

*RD *READ Ifn 

*R *REST0RE 1 

♦RESTORE 11,12 

*RW *REWIND Ifn 

*SP *SELPURGE deckl.identl,deck2.ident2, 

. . . ,deckn.identn 

*SY *SELYANK deckl.identl,deck2.ident2, 

. . . ,deckn-identn 

*S *SEQUENCE deckl,deck2.deckn 

♦SEQUENCE deckl.deck2 
*$K *SKIP 1fn,n 

*T *TEXT 


Write specified number of following lines to 
the compile file if name of type DECK, IDENT, 
or DEF is unknown. 

Write subsequent text lines after line 
identified. 

Limit listable output to n lines. 

Resume listing cards encountered in input 
stream. 

Place deckl after deck2. 

Do not check for abbreviated directives. 

Disable list option 4. 

Re-create specified correction sets and 
write them to file specified by the G 
option. 

Permanently remove specified decks from 
program library. 

Permanently remove inclusive range of decks. 

Permanently remove specified correction sets 
from program library. 

Permanently remove inclusive range of 
correction sets. 

Permanently remove specified correction set 
and all sets introduced after it. 

Read directives and text from specified file. 

Reactivate specified line and optionally 
insert text after it. 

Reactivate inclusive range of lines and 
optionally insert text after them. 

Reposition named file to beginning-of- 
information. 

Permanently remove all lines in specified 
deck that belong to specified correction set. 

Deactivate all lines in specified deck that 
belong to specified correction set. 

Resequence all active lines and purge all 
inactive lines in specified decks. 

Resequence all active lines and purge all 
inactive lines in inclusive range of decks. 

Reposition named file forward the specified 
number of logical records. 

Beginning delimiter for sequence of lines 
identifying text. 
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TABLE 3-1. SUWtARY OF UPDATE DIRECTIVES (Contd) 


Directive Keyword 
Abbreviation 

Directive Format 

Use 

*W 

♦WEOR level 

Write end-of-record or end-of-flle according 
to specified level. 

*WI 

♦WIDTH linelen.ldlen 

Reset size of line image written to compile 
file. 

*Y 

♦YANK identl,ident2, . . . .identn 

Temporarily remove specified correction sets 
from program library. 


♦YANK identl.ident2 

Temporarily remove inclusive range of 
correction sets. 

*YD 

♦YANKDECK deckl,deck2, . . . ,deckn 

Temporarily deactivate decks specified. 

none 

♦/comment 

Copy text to listable output file. 


seqnum 

Expands to idname.seqnum where idname is a 
correction set identifier, whether or not it is 
also a deck name. 

.seqnum 

Expands to dname.seqnum where dname is a 
deck name. 


Figure 3-3. Expansion of Short Forms of Card Identification 


All deck names are also identifiers (but all identifiers are 
not deck names). Thus, if EXAMPLE is the deck name last 
used, and there is no subsequent explicit reference to a 
correction set identifier, then both .281 and 281 expand to 
EXAMPLE.281 as the card identifier. If there is an explicit 
reference to a correction set identifier ABC after the 
explicit reference to the deck name, then 281 would expand 
to the card identifier ABC.281 while .281 would expand to 
EXAMPLE.281. 


Fiqure 3-4 shows the differences in identifier expansion 
depending on the order of the directives. A is a deck name 
and B is a correction set. identifier on an old proqram 
library. 


*10 C 

•INSERT A.2 

data card 
•INSERT B.1 

data card 


•D 

2, 3 

expands 

to ‘DELETE 

B.2,6.3 

*D 

4, .5 

expands 

to ‘DELETE 

B.4,A.5 

*D 

.7, 5 

expands 

to ‘DELETE 

A.7.B.5 

•D 

.9, .10 

expands 

to 'DELETE 

A.9.A.10 

whereas: 




•ID 

D 




•INSERT B.1 





data card 




•INSERT A.2 





data card 




*D 

2, 3 

expands 

to 'DELETE 

A.2.A.3 

*D 

4, .5 

expands 

to 'DELETE 

A.7.A.5 

*D 

.7, 5 

expands 

to 'DELETE 

A.7,A.5 

*D 

.9,-10 

expands 

to 'DELETE 

A.9,A.10 


Figure 3-4. Examples of Card Identifier Expansion 


DECK IDENTIFYING DIRECTIVES 

Each deck to be placed on a program library must be 
introduced into the system by a DECK or COMDECK 
directive during a creation or correction run. When Update 
encounters one of these directives in the input stream prior 
to any correction directive, the run is considered to be a 
creation run. When Update encounters one of these 
directives while inserting new text cards, it terminates the 
insert and adds the decks to the program library following 
the card specified. 

When a deck is added through the use of a DECK or 
COMDECK directive during a creation run or an ADDFILE 
directive during a correction run, termination of that deck 
occurs when Update encounters another DECK or 
COMDECK directive, or the end of a system-logical 
record. Cards within that deck are identified by the name 
of the deck or common deck tc which the cards belong and 
are numerically sequenced beginning with 1 for the DECK 
or COMDECK directive. When a deck is inserted during a 
correction run as if it were text (that is, through the use of 
an INSERT, DELETE, BEFORE, or RESTORE directive), 
the deck is terminated by any condition that normally 
terminates insertion. The contents of the deck, including 
the DECK or COMDECK card, are identified by the 
correction set name and are numerically sequenced as if 
they were normal insertion text. 

Frequently, a DECK or COMDECK directive precedes each 
program or subprogram in a given program library. More 
than one subprogram, however, can be included in a deck, 
as is indicated in figure 3-5. Normally, two programs are 
grouped together if modification of one program requires 
reassembly of both programs. 

Because DECK and COMDECK directives can be 
deactivated by DELETE, YANK, or SELYANK, card images 
belonqinq to one deck at the beginninq of an Update run 
can belong to a different deck at the end of the run. When 
a DECK or COMDECK directive is deactivated, all card 
images in the deactivated deck become members of the 
preceding deck on the proqram library; they retain their 
original card identifiers. If there is no preceding deck, 
then they become part of the YANK$$$ deck. 
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•DECK 

FIRST 

IDENT 

FIRST 


END 

IDENT 

SECOND 


END 


•COMDECK 

FDATA 

BLOCK DATA 

COMMON/J3/ACIO) 

DATA A/3’0., 7*1.0/ 

END 


Figure 3-5. Example of Deck Structure 


DECK DIRECTIVE 

The DECK directive establishes a deck in the program 
library. It is one of the two directives that establishes the 
existence of a creation run. The directive can also be used 
in any correction run to add a deck to the location 
indicated by a preceding INSERT, BEFORE, DELETE, or 
RESTORE directive. Each deck must have a unique name 
within the program library. The DECK directive itself is 
part of the program library and has a sequence number of 
one within the name established by the directive. DECK 
directive format is shown in figure 3-6. 


•DECK deck 

deck Name of deck. Must be 1 through 9 characters. 
A through Z, 0 through 9, or + -/*{)$ =. 
Must not duplicate the name of any other deck 
in program library. 


Figure 3-6. DECK Directive Format 

COMDECK DIRECTIVE 

The COMDECK directive establishes a common deck that 
can be called from other decks as they are being written to 
the compile file. It is one of the two directives that 
establishes the existence of a creation run. The directive 
can be used in any correction run to add a common deck to 
the location specified by a precedinq INSERT, BEFORE, or 
RESTORE directive. Each common deck must have a 
unique name. The COMDECK directive itself is part of the 
program library and has a sequence number of one within 
the name established by the directive. The COMDECK 
directive format is shown in figure 3-7. 

The NOPROP parameter of the COMDECK directive 
determines whether a deck calling a corrected common 
deck is to be considered as having been corrected. If 
NOPROP is specified, only the common deck is considered 
to be corrected. On the other hand, if NOPROP is not 
specified, the common deck and the calling decks are 
considered to be corrected. 

A common deck should be placed before any of the decks 
that call it. If the common deck is placed after a deck that 
calls it, Update may not be able to find it. In addition, 
decks calling a corrected common deck are not written to 
the compile file if the calling deck precedes the common 
deck and the mode is normal selective. 


•COMDECK deck,NOPROP 

deck 

Name of deck. Must be 1 through 9 
characters A through Z, 0 through 9, or 
+ -/*()$=. Must notduplicate name of 
an existing deck. 

NOPROP 

Indicates that decks calling this common deck 
are not to be considered as modified when 
the common deck itself is modified; that is, 
the effects of common deck changes are not 
to be propagated during normal Update mode. 
Optional. 


Figure 3-7. COMDECK Directive Format 


CORRECTION DIRECTIVES 

Correction directives control updating of the old program 
library. New text is assigned a unique card identifier based 
on the correction set identifier. The corrected program 
library is written on the new program library; the old 
proqram library is not actually changed. Correction 
directives are illegal on a creation run. 


ADDFILE DIRECTIVE 

The ADDFILE directive causes Update to add a file of 
decks to the new program library. ADDFILE differs from 
the READ directive in that the conents of the specified file 
are limited to those allowed on a creation run. Unless the 
specified file is the primary input file, the READ directive 
cannot appear in the added file. The first card image of 
the specified file must be a DECK or COMDECK 
directive. If the INPUT file is specified, the READ 
directive can be the first image; a DECK or COMDECK 
directive must then be the first card image on the file 
specified by the READ directive. An ADDFILE directive 
cannot appear among directives read from the file 
specified by a READ directive. The ADDFILE directive 
format is shown in figure 3-8. If only one parameter is 
specified, it is assumed to be lfn. 


•ADDFILE lfn,name 

lfn Name of local file from which decks are to be 
added. If lfn is omitted, the default is the file 
specified by the I parameter of the Update control 
statement; the separators are still required. 

name Name of deck or identifier of card after which 
decks are to be placed on the program library. 

If omitted, the addition is made after the last 
deck on the program library. 

If the name parameter is *, it refers to the ident 
that is known to be a deck name most recently 
mentioned on a BEFORE, COPY, DELETE, 
INSERT, or RESTORE directive, tf no such 
directive precedes the ADDFILE, the YANK$$$ 
deck is used. 


Figure 3-8. ADDFILE Directive Format 
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When the specified file is not the primary input file, 
Update adds directives and text until the end of one 
system-logical record is encountered. Update then returns 
to the file specified by the I parameter of the UPDATE 
control statement and continues processing the primary 
input stream. When the file specified on the ADDFILE 
directive is the primary input file, however, Update adds 
card images until a noncreation directive or the end of the 
system-logical record is encountered. 

Update does not reposition the file specified on the 
ADDFILE directive. Any repositioninq must be requested 
by the SKIP or REWIND directive. 

BEFORE DIRECTIVE 

The BEFORE directive inserts text card images and 
compile file directives in the program library before the 
specified card image. The card images to be inserted are 
placed immediately after the directive. Card images 
cannot be inserted into the YANK$$$ deck. The inserted 
card images receive card identifiers established by the 
correction set name of the preceding IDENT directive. The 
BEFORE directive format is shown in figure 3-9. 


‘BEFORE c 

c Card identifier of card before which the insertion 
is to be made. 


Figure 3-9. BEFORE Directive Format 


Unless a TEXT directive has been encountered, Update 
terminates an insertion when it encounters the next 
insertion directive or a PURGE, PURDECK, IDENT, 
| SELPURGE, ADDFILE, or SEQUENCE directive. On the 
other hand, compile file directives are inserted as if they 
are text after Update checks for correct syntax. Update 
interprets all other directives without terminating 
insertion; however, the directives are not inserted into the 
deck. 


CHANGE DIRECTIVE 

The CHANGE directive renames correction set identifiers. 
It cannot be used to change deck names. As a secondary 
effect, changing the name of the correction set invalidates 
any YANK or 5ELYANK directives that refer to the set by 
its previous name. Since a CHANGE directive qoes into 
effect immediately, any subsequent references to the 
correction set must use the new name. The CHANGE 
directive need not be part of a correction set. CHANGE 
directive format is shown in figure 3-10. 


•CHANGE oldid,newid.oldid.newid 

oldid Name of correction set to be changed. 

newid New correction set name. Must be 1 through 9 
characters A through Z, 0 through 9, or + - / * 
( ) $ =. Must not duplicate the name of any 
other correction set in the program library. 


Figure 3-10. CHANGE Directive Format 


COPY DIRECTIVE 

The COPY directive copies active card images from a deck 
on the old program library and inserts the images into 
another deck as if they are text in an input stream, or the 
COPY directive copies active card images to a specified 
file. Since Update copies the card images into a deck 
before applying corrections to them, card images can be 
copied aid original images can be modified in the same 
run. An attempt to copy card images introduced during the 
same Update run produces an informative message. The 
COPY directive format for copying card images to a deck 
on the program library is shown in figure 3-11. The COPY 
directive format for copying card images to a file is shown 
in figure 3-12. 


A. 

Copy specified line. 


•COPY deck.c 


deck 

Name of deck on old program library that 
contains the line to be copied. 


c 

Line identifier of line to be copied. 

B. 

Copy range of cards. 


•COPY deck,c1,c2 


deck 

Name of deck on old program library that 
contains cards to be copied. 


c1,c2 

Card identifiers of first and last cards in 
sequence of cards to be copied. 


Figure 3-11. COPY Directive Format - Copy to Deck 


•COPY deck,c1,c2,lfn 

deck Name of deck on old program library that con¬ 
tains lines to be copied. 

d,c2 Card identifiers of first and last lines in 
sequence of lines to be copied. 

Ifn Name of file onto which cards are to be copied. 
The user is responsible for the disposition of 
this file since it is not positioned either before 
or after the copy. The file is written as a 
binary file that contains 256-column line images 
with one system-logical record {Section for 
SCOPE2) for each COPY directive; sequencing 
information is not included. 


Figure 3-12. COPY Directive Format - Copy to File 


An INSERT, DELETE, BEFORE, or RESTORE directive 
must be in effect to use COPY for copying card images to 
a deck. In figure 3-13, example A, the use of the COPY 
directive is valid because a preceding INSERT directive has 
initiated insertion. Card images BDECK.4 through 
BDECK.8 are copied and inserted after the text cards. The 
copied card images are sequenced as part of correction 
set X. The input stream in figure 3-13, example B, is not 
valid because insertion is not in effect to indicate where to 
write the card image copies. 
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A. Valid use of COPY. 


'IDENT X 
'INSERT BLAP.11 
{text cards) 

'COPY BDECK,BDECK.4,BDECK.8 
B. Invalid use of COPY. 

'IDENT X 

'COPY BDECK,BDECK.4,BDECK,8 


Figure 3-13. COPY Directive Example 


Placement in the input stream of a COPY directive that 
copies card images to a file is not restricted; COPY can 
appear anywhere in the primary input stream. Copying 
card images to a file is illegal, however, when a secondary 
input stream is being read as a result of a READ directive. 


DELETE DIRECTIVE 

The DELETE directive deactivates a card image or a aroup 
of card images arid optionally inserts text and directives 
after the deleted card images. The card images to be 
inserted are placed immediately after the directive. The 
inserted card images receive card identifiers established by 
the correction set name of the preceding IDENT directive. 
The DELETE directive format depends on whether card 
images to be deactivated are specified by card identifier or 
by a range of cards, as shown in figure 3-14. 

A. Delete specified card 

'DELETE c 

c Line identifier for single line to be deleted. 

B. Delete range of cards 

‘DELETE c1,c2 

c1,c2 Card identifiers of first and last cards, 
in sequence of cards to be deleted. Card 
cl must appear before c2 in the existing 
library. The range can include cards already 
in a deactivated state. 


Figure 3-14. DELETE Directive Format 


are sequenced within the name specified. All correction 
set names must be unique. If a new proqram library is not 
being generated, a correction set need not begin with an 
IDENT directive. In this case, Update uses the default 
name of .NO.ID. for new text cards. The established 
correction set identifier remains in effect until Update 
encounters another IDENT directive or a PURGE, 
SELPURGE, PURDECK, ADDFILE, or SEQUENCE 
directive. IDENT directive format is shown in figure 3-13. 


■ 


f I DENT idname,B=num,K=ident,U=ident 

dname Name to be assigned to this correction set. 

Must be 1 through 9 characters A through 
Z, 0 through 9, or + -/*{)$ =. Must 
not duplicate the name of another correction 
set or deck. This directive causes a new entry 
in the directory. 

3=num Bias to be added to sequence numbers within 
deck. Optional; 1 is default. 


K=ident 


Indicator that specified correction set name 
must exist in the directory of the library 
before corrections can be made. Optional. 

Indicator that specified correction set name 
must not exist in the directory of the library. 
Optional. 


Figure 3-15. IDENT Directive Format 


Omittinq idname causes a format error. If idname 
duplicates a name previously used, Update issues an error 
message. Both errors are nonfatal as long as no new 
program library is created in the same run. 

The B, K, and U parameters on the IDENT directive can 
appear in any order. If more than one B parameter is 
specified, Update uses the last one encountered. More than 
one K or U parameter can be specified; in this instance, all 
correction set names must be known or unknown as 
specified before the correction set is processed. (An 
identifier is known whether it is active or inactive; an 
identifier that has been yanked is still known. To become 
unknown, an identifier must be purged.) If the criteria of 
these parameters is not met, Update skips the correction 
set and resumes processing with the next IDENT, PURGE, 
SELPURGE, PURDECK, or ADDFILE directive. 

In the following example, the bias of 100 is added to all 
ZAP correction set card sequence numbers: 


Unless a TEXT directive has been encountered, Update 
terminates an insertion when it encounters the next 
insertion directive or a PURGE, PURDECK, IDENT, 
SELPURGE, ADDFILE, or SEQUENCE directive. On the 
other hand, compile file directives are inserted as if they 
are text after Update checks for correct syntax. Update 
interprets all other directives without terminating 
insertion; however, the directives are not inserted into the 
deck. 


IDENT DIRECTIVE 

The IDENT directive establishes the name for the set of 
corrections beinq made. Cards added in this correction set 


♦IDENT ZAP,B=100,K=ACE,U=NON,U=ARF 

The first card image in correction set ZAP has a sequence 
number of 101, not 1. Update skips the correction set if 
ACE is unknown or either NON or ARF is known. 


INSERT DIRECTIVE 

The INSERT directive inserts text card images and compile 
file directives in the program library after the specified 
card imaqe. The card images to be inserted are placed 
immediately after the directive. Card images cannot be 
inserted into the YANK$$$ deck. The inserted card images 
receive card identifiers established by the correction set 
name of the preceding IDENT directive. INSERT directive 
format is shown in figure 3-16. 


60449900 C 


3-7 



•INSERT c 

c Card identifier of card after which insertion is to 
be made. 


Figure 3-16. INSERT Directive Format 


Unless a TEXT directive has been encountered, Update 
terminates an insertion when it encounters the next 
insertion directive or a PURGE, PURDECK, IDENT, 
SELPURGE, ADDFILE, or SEQUENCE directive. On the 
other hand, compile file directives are inserted as if they 
are text after Update checks for correct syntax. Update 
interprets all other directives without terminating 
insertion; however, the directives are not inserted into the 
text. 


A. 

Purge decks listed 



‘PURDECK deck1,deck2, . . . ,deckn 



deck Name of deck to be purged. 

can appear in any order. 

Names 

B. 

Purge range of decks 



•PURDECK deckl ,deck2 



deckl.deck2 Names of first and last decks, inclu¬ 
sive, to be purged. Names must 
appear in the relative order in which 
decks exist in the deck list. 


Figure 3-18. PURDECK Directive Format 


MOVE DIRECTIVE 

The MOVE directive enables the user to reorder decks 
while producing a new proqram library. The deck to be 
repositioned is moved from its position on the old program 
library and placed after the specified deck on the new 
program library. The YANK$$$ deck cannot he moved. A 
MOVE referencing a deck introduced in the same Update 
run produces an informative message. This directive does 
not terminate insertion and need not be part of a 
correction set. MOVE directive format is shown in 
figure 3-17. 


•MOVE deck1,deck2 

deckl Deck name on old program library to be moved. 

deck2 Deck name after which deckl is to be placed 
on new program library. 


Figure 3-17. MOVE Directive Format 


PURDECK DIRECTIVE 

The PURDECK directive permanently removes a deck or 
group of decks from the program library. However, the 
YANK$$$ deck cannot be purged. Every card image in a 
deck is purged, regardless of the correction set that 
contains the card image. Purging, unlike yanking, cannot 
be rescinded. A PURDECK directive can appear anywhere 
in the input stream; its appearance terminates the current 
correction set. PURDECK directive format depends on 
whether decks to be purged are specified individually by 
deck name or by a range of deck names, as shown in 
figure 3-18. 

The name of a purged deck is removed from the deck list; 
it can be reused as a deck name. An entry for the purged 
deck remains in the directory, however, until removed 
through the use of the E parameter on the UPDATE control 
statement. The deck name can also be removed from the 
directory by resequencing the library, that is, by creatinq a 
source file in one Update run and then using the source file 
as input on a subsequent creation run. Until a deck name is 
removed from the directory, it cannot be used as a 
correction set identifier. (See the PURGE directive.) 


PURGE DIRECTIVE 

The PURGE directive permanently removes a correction 
set or qroup of correction sets from the program library. 
Every card in the correction set is purged, regardless of its 
status as active or inactive. Purging, unlike yankinq, 
cannot be rescinded. A new program library written during 
the same run will treat the purged correction set as if it 
had never existed. A PURGE directive can appear 
anywhere in the input stream; it terminates the current 
correction set. PURGE directive format, as shown in 
figure 3-19, depends on whether correction sets to be 
purged are specified individually by correction set name, by 
a range of correction set names, or by relative time of 
introduction into the program library. 


A. Purge listed correction sets 

•PURGE ident1,ident2, . . . ,identn 

ident Identifier of a correction set to be 

purged. Identifiers can appear in any 
order. 

B. Purge range of correction sets 

•PURGE ident1.ident2 

ident1.ident2 Identifiers of first and last correction 

sets, inclusive, to be purged. Identifiers 
must appear in the relative order in 
which the correction sets were intro¬ 
duced into the program library; that is, 
they must appear in the order they 
exist in the directory. 

C. Purge later correction sets 

•PURGE ident,* 

ident Identifier of correction set to be purged 

along with all correction sets introduced 
after the specified correction set. 

* Indicator that the program library is to 

return to an earlier level. Intervening 
PURGE directives and SEQUENCE 
directives prevent complete return. 


Figure 3-19. PURGE Directive Format 
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If Update cannot locate a specified correction set, it issues 
an error message. Purged identifiers can be reused on 
subsequent correction sets provided they do not appear in 
the YANK$$$ DECK as a YANK directive parameter. 


RESTORE DIRECTIVE 

The RESTORE directive reactivates a card image or a 
group of card images previously deactivated throuqh a 
DELETE directive. Any text card images and compile file 
directives immediately following the RESTORE directive 
are inserted after the last card image identified on the 
directive. Any inserted card images receive card 
identifiers established by the correction set name of the 
preceding IDENT directive. RESTORE directive format 
depends on whether card images to be reactivated are 
specified by card identifier or by a ranqe of cards, as shown 
in figure 3-20. 


A. Restore specified card. 

•RESTOREc 

c Card identifier of card to be restored. 

B. Restore range of cards. 

•RESTORE c1,c2 

c1,c2 Card identifiers of first and last cards, 
inclusive, in sequence of cards to be 
restored. Card cl must appear before c2 in 
the existing library. Any cards in the 
sequence that are already active are not 
affected. 


Figure 3-20. RESTORE Directive Format 


Unless a TEXT directive has been encountered, Update 
terminates an insertion when it encounters the next 
insertion directive or a PURGE, PURDECK, IDENT, 
SELPURGE, ADDFILE, or SEQUENCE directive. On the 
other hand, compile file directives are inserted as if they 
are text after Update checks for correct syntax. Update 
interprets all other directives without terminating 
insertion; however, the directives are not inserted into the 
deck. 


SELPURGE DIRECTIVE 

The SELPURGE directive permanently removes the effects 
of the specified correction set on the specified deck. Only 
the card images belonging to the specified correction set 
are purged from the specified deck. Oard images belonging 
to the specified correction set that are in other decks are 
not purged. Card images in the YANK$$$ deck can be 
purged through SELPURGE. A SELPURGE directive can 
appear anywhere in the input stream; it terminates the 
current correction set. SELPURGE directive format is 
shown in figure 3-21. 


•SELPURGE deckl.identl, . . . .deckn.identn 

deck Name of deck from which correction set is to 
be removed. 

ident Name of correction set to which cards to be 
removed belong. It must be separated from 
the deck by a period. 


Figure 3-21. SELPURGE Directive Format 


SELYANK DIRECTIVE 

The SELYANK directive temporarily removes the effects 
of the specified correction set on the specified deck. Only 
the card images belonging to the specified correction set 
are yanked from the specified deck. Card images belonging 
to the specified correction set that are in other decks are 
not yanked. Card images in the YANK$$$ deck can be 
yanked throuqh SELYANK. A SELYANK directive must be 
part of a correction set; it is placed in the YANK$$$ deck. 
The SELYANK directive format is shown in figure 3-22. 


‘SELYANK deckl.identl, . . . ,deckn.identn 

deck Name of deck from which correction set is to 

be removed. 

ident Name of correction set to which cards to be 

removed belong. It must be separated from 
deck by a period. 


Figure 3-22. SELYANK Directive Format 


SEQUENCE DIRECTIVE 

The SEQUENCE directive resequences active cards and 
purges inactive cards from the specified deck(s). Only 
those decks explicitly mentioned on the SEQUENCE 
directive are resequenced. Thus, if a correction set (for 
example, SET1) affects more than one deck on a program 
library (for example, DECK1 and DECK2), and only DECK1 
has been subsequently resequenced through SEQUENCE, 
the SEQUENCE directive does not affect SET1 cards within 
DECK2. The YANK$$$ deck cannot be resequenced. 
SEQUENCE directive format, as shown in figure 3-23, 
depends on whether decks to be resequenced are specified 
individually by name or are specified as a range of deck 
names. 

Update normally allows deck and correction sets having the 
same name to coexist on the old program library. If a deck 
having the same name as a correction set is resequenced 
and cards for the correction set are in other decks, Update 
purges any modifications made by that correction set 
outside the resequenced deck to prevent duplicate 
identifiers. 

The SEQUENCE directive does not result in identifiers 
beino deleted from the directory even if, as a result of 
resequencing, no references to an identifier are on the 
library. This situation arises when all the corrections of a 
correction set refer to a deck that is resequenced. 
Deletion of the identifier, in this case, requires an edit 
(E parameter) or PURGE in a subsequent Update run. 
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A. 

Resequence listed decks. 



'SEQUENCE 

deck1,deck2, . . . 

deckn 


deck 

Name of deck to 

ae resequenced. 

B. 

Resequence range of decks. 



"SEQUENCE 

deck1.deck2 



deck1.deck2 

Name of first and last decks, inclusive, 
to be resequenced. Deckl must 
appear before deck2 in old program 
library. 


Figure 3-23. SEQUENCE Directive Format 


A deck cannot be renamed and resequenced in the same 
Update run. (To rename a deck, delete the first card of the 
deck and replace it with a new DECK directive containing 
the new name.) 


YANK DIRECTIVE 

The YANK directive temporarily removes a correction set 
or group of correction sets from the program library. Card 
images activated by the correction set are deactivated; 
card images deactivated by the correction set are 
reactivated. If a correction set has been yanked, it is 
ignored during compile file or source file generation. The 
effects of the YANK directive can be selectively nullified 
through the introduction of DO and DONT directives in the 
decks. Update places the YANK directive in the YANK$$$ 
deck. The YANK directive format, as shown in 
figure 3-24, depends on whether correction sets to be 
yanked are specified individually by correction set name or 
by a range of correction set names. 


A. Yank listed correction sets 

"YANK ident1,ident2, . . . ,identn 

ident Identifier of a correction set to be 

yanked. Identifiers can appear in 
any order. 


B. Yank range of correction sets 
"YANK ident1.ident2 

ident1.ident2 Identifiers of first and last correction 
sets, inclusive, to be yanked. Identi¬ 
fiers must appear in the relative order 
in which the correction sets were 
introduced into the program library; 
that is, they must appear in the order 
they exist in the directory. 


Figure 3-24. YANK Directive Format 


The YANK directive differs from PURGE in several 
respects; YANK must be part of a correction set; YANK 
does not terminate the current correction set; and the 
effects of a YANK directive can he rescinded. 


YANKDECK DIRECTIVE 

The YANKDECK directive temporarily removes all cards 
within the decks specified. All cards are deactivated, even 
if they belong to a correction set. YANKDECK differs 
from PURDECK in several respects: YANKDECK must be 
part of a correction set; it does not terminate the current 
correction set; and its effects can be rescinded. The 
YANKDECK directive format is shown in figure 3-23. 


"YANKDECK deck1,deck2, . . ,,deckn 

deck Name of deck to be yanked. Names can appear 
in any order. 


Figure 3-25. YANKDECK Directive Format 


The deck YANK$$$ cannot be deactivated as a whole. 
Individual YANK directives within this deck can be yanked 
by a YANK directive, however. 


COMPILE FILE DIRECTIVES 

Compile file directives provide control over the compile 
file. These directives are interpreted when the proqram 
library decks are being corrected and written onto the 
compile file. Calls for common decks result in the common 
deck beinq written on the compile file. Other directives 
allow control of file format. None of the compile file 
directives are written on the compile file. 

The user can prepare the original deck with embedded 
compile file directives (except for DO or DONT) or the 
user can insert compile file directives into program library 
decks as a part of a correction set. Compile file directives 
are not processed when they are encountered in the input 
stream (except for COMPILE); they are simply considered 
as text cards to be inserted and sequenced accordingly 
after update checks for correct syntax. To be recognized 
while the compile file is being written, these directives 
must have the same master control character as defined 
when the library was created. 


CALL DIRECTIVE 

The CALL directive causes the active text of a common 
deck to be written onto the compile file. The directive 
itself is stored as part of a deck and can be referenced by 
its card identifier. CALL is effective only within a deck or 
common deck. Common decks can call other common 
decks, but a common deck must not either call itself or call 
a common deck that contains a call to the common deck. 
Neither the CALL directive nor the COMDECK directive 
which defined the deck is written to the compile file. The 
CALL directive format is shown in figure 3-26. 


"CALL deck 

deck Name of an existing common deck to be written 
to the compile file. 


Figure 3-26. CALL Directive Format 
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Common decks can also be called from secondary old 
program libraries. If COMDECK names are duplicated on 
any secondary old proqram libraries, Update uses the first 
COMDECK encountered according to the order of the 
secondary old program libraries as specified hy the P 
parameter of the UPDATE control statement. 


COMPILE DIRECTIVE 

The COMPILE directive indicates which decks are to be 
written to the compile file during normal or quick Update 
mode. The directive is ignored durinq a full Update. 

Normal mode Decks specified on COMPILE directives 
and corrected decks are written to the 
compile file. 

Quick mode Decks specified on COMPILE directives 
and any common decks called by the 
directives are written to the compile 
file. 

The directive also affects the contents of any new program 
library and source file as shown in table 2-2. The 
COMPILE directive format, as shown in figure 3-27, 
depends on whether decks to be written are specified 
individually by name or are specified as a range of deck 
names. 


A. Compile listed decks 

'COMPILE deck1,deck2, . . . ,deckn 

deck Name of deck to be written to the 

compile file, new program library file, 
and source file. 

B. Compile range of decks 

'COMPILE deck1.deck2 

deck1.deck2 Names of first and last decks in range, 
inclusive, to be written to the compile 
file. The name of deckl must appear 
before the name of deck 2 in the old 
program library deck list. 


Figure 3-27. COMPILE Directive Format 

Decks are written to the compile file in the order that the 
decks exist on the old program library, unless the K option 
is selected on the UPDATE control statement. If the K 
option has been specified, the decks are written in the 
order they appear on the COMPILE directive. 

When a deck is being introduced in the same run that 
contains a COMPILE directive for the deck, the DECK 
directive must appear before the COMPILE directive. 
Otherwise, COMPILE directives can be anywhere in the 
input stream. They do not affect the current correction 
set name. 


CWEOR DIRECTIVE 

The CWEOR directive causes the termination of the 
current system-logical record (current section for 
SCOPE 2) on the compile file with the specified level. 
Termination occurs only if information has been placed in 


the output buffer since the last system-logical record was 
written. The CWEOR directive format is shown in 
figure 3-28. 


‘CWEOR level 



level Level of system-logical 

record. 

For SCOPE 2, the following: 

RT=W 

0 thru 14 

end-of-section 

RT=W 

15 

end-of-partition 

RT=S 

0 thru 15 

end-of-record 

RT=Z 

0 thru 15 

end-of-section 

BT=C 

0 thru 15 

end-of-section 


Figure 3-28. CWEOR Directive Format 


DO DIRECTIVE 

The DO directive causes Update to rescind a yank of 
specified correction sets while writing text to the compile 
file. If a card was deactivated as a result of a YANK or 
SELYANK, the card is reactivated. Likewise, if a card was 
activated by a YANK or SELYANK, Update deactivates it. 
A DO remains in effect until a DONT directive is 
encountered. The DO directive can be placed anywhere in 
the library. If Update encounters a DO for an unyanked 
correction set, an informative message is issued and the 
DO is ignored. The DO directive format is shown in 
figure 3-29. 


'DO identl ,ident2, . . . .identn 

ident Name of correction set for which yanking is 
to be rescinded or initiated. 


Figure 3-29. DO Directive Format 


DONT DIRECTIVE 

The DONT directive terminates a DO directive. It can also 
be used to initiate a yank of an unyanked correction set. 
When Update encounters a DONT for a correction set that 
has not been yanked, it yanks the set until it encounters a 
DO directive for the set. If the correction set has already 
been yanked, Update issues an informative message and 
ignores the DONT. The DONT directive can be placed 
anywhere in the program library. The DONT directive 
format is shown in figure 3-30. 


'DONT identl,ident2, . . .,identn 

ident Name of correction set for which yanking is to 
be rescinded or initiated. 


Figure 3-30. DONT Directive Format 


ENDIF DIRECTIVE 

The ENDIE directive indicates the end of conditional text. 
It is used with IF when the num parameter is omitted from 
the IF directive. ENDIF should not be used if num is 
specified on the IF directive. Since num takes precedence, 
the ENDIF directive is included in the count of active cards 
and is written on the compile file. The ENDIF directive 
format is shown ir> figure 3-31. 
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WEOR DIRECTIVE 


•ENDIF 


Figure 3-31. ENDIF Directive Format 

IF DIRECTIVE 

The IF directive conditionally writes text on the compile 
file. When Update encounters an IF directive, the text 
following the directive is written or skipped depending on 
the condition. The IF directive format, as shown in 
figure 3-32, depends on whether the specified name is to be 
known or unknown for the text to be written on the compile 
file. 


A. Name must be known {on old program library). 

*IF type,name,num 

B. Name must be unknown (not on old program library). 
*IF -type,name,num 

type Type of condition name. 

DECK Name is deck name. To be known, it 
must be in the deck list on the primary 
old program library. 

IDENT Name is correction set identifier. To 
be known, it must be in the directory 
on the primary old program library. 

DEF Name is defined through DEFINE 

directive on the old program library. 

When type is not preceded by a minus sign, the 
name must be known for text to be written. When 
type is preceded by a minus sign, the name must 
not be known for text to be written. 

name Deck name, correction set identifier, or defined 
name, according to type. 

num Number of active card images to be skipped if 
condition is not met. Optional. 


Figure 3-32. IF Directive Format 

If the num parameter is omitted and the condition is not 
met, Update searches for an ENDIF directive and resumes 
processing of the deck at that point; if ENDIF is not found, 
then the remainder of the PL is skipped and the compile 
file stops at this point; no error message is written. When 
the condition is met, no cards are skipped. 

When an IF directive is encountered on a secondary old 
program library, Update only searches the directory, deck 
list, and YANK$$$ deck on the orimary old orogram library 
in trying to satisfy the conditional. The deck lists, 
directories, and YANK$$$ decks of the secondary old 
proqram libraries are not searched. 

When both an IF directive is encountered as a result of a 
CALL and a matching ENDIF directive is found as the 
result of a second CALL, the ranqe of the IF, ENDIF pair is 
unpredictable. 


The WEOR directive causes the termination of the current 
system-logical record on the compile file with the specified 
level. The WEOR directive format is shown in figure 3-33. 


‘WEOR level 



level Level 

of system-logical 

record. 

For SCOPE 2, the following: 

RT=W 

0 thru 14 

end-of-section 

RT=W 

15 

end-of-partition 

RT=S 

0 th ru 15 

end-of-record 

RT=Z 

0 thru 15 

end-of-section 

BT=C 

0 thru 17 

end-of-section 


Figure 3-33. WEOR Directive Format 


WIDTH DIRECTIVE 

The WIDTH directive overrides the default compile file 
card image width settings, as specified by D and/or 8 on 
the UPDATE control statement. The format for the 
WIDTH directive is shown in figure 3-34. 


•WIDTH 

cardlen.idlen 

cardlen 

Number of characters of line image text 


that is written. 

idien 

Width of the identification field following 


the line image. 


Figure 3-34. WIDTH Directive Format 


The sum of the length of cardlen and idien must be equal to 
or less than 256 characters. If idien is set to 0 (zero), the 
identification field is suppressed. The format of the fields 
cardlen and idien are shown in figure 3-35. The sequence 
data (S) is positioned within the identifier name field (I) by 
the following procedure: 

1. Blanking the field. 

2. Putting in the identifier name, left-justified with 
truncation on the left as needed. 

3. Placinq the sequence number over the field, 
right-justified with truncation on the left as needed. 



3-12 


60449900 C 




Table 3-2 shows the three possible widths of the 
identification field and the positioning of the identifier 
name and the sequence number. The total length possible 
for the identification field is 17. 


TABLE 3-2. SEQUENCE NUMBER OVERLAY 


Identification 
Field Length 
(idlen) 

Field Positions (S and I) 

idlen > 17 

Field I occupies 16 character 
positions. 

Field S is the length of idlen 
minus 16 blank(s). 

14 s idlen s 16 

Field I is the length of idlen 
minus 1 character position. 

Field S is a blank. 

idlen < 14 

Field I is the length of idlen. 
Field S is empty. 

(Fields I and S can both be 
empty if idlen is 0.) 


If *WIDTH is specified with no parameters, the run default 
settings are restored. If only the length of the 
identification field is specified (*WIDTH ,idlen), then 
cardlen is the previous settinq used. If only cardlen is 
specified (*WIDTH cardlen), then the previous setting of 
idlen is used. 


FILE MANIPULATION DIRECTIVES 

File manipulation directives control secondary input files 
during Update processing. These directives can only appear 
in the primary input stream. They are illegal on a 
secondary input file. 

READ DIRECTIVE 

The READ directive temporarily stops reading the primary 
input stream and begins readinq an input stream from the 
specified file. READ differs from ADDFILE in that the 
content of the file specified by READ is not restricted 
except to prohibit the appearance of another READ 
directive or the ADDFILE, SKIP, and REWIND directives. 
Update reads from the specified file one system-loqical 
record (section for SCOPE 2). Processing then continues 
with the main input stream. The READ directive format is 
shown in figure 3-36. 


•READ Ifn 

Ifn Name of alternate file containing input stream. 


Figure 3-36. READ Directive Format 

The specified file cannot be one of the reserved files 
specified by a parameter on the UPDATE control 
statement. It can only be a local secondary input file. 


REWIND DIRECTIVE 

The REWIND directive repositions the specified file to 
beqinning-of-information. The file to be rewound cannot 
be one of the reserved files. It can only be a secondary 
input file. The REWIND directive format is shown in 
figure 3-37. 


‘REWIND Ifn 

Ifn Name of file to be rewound. 


Figure 3-37. REWIND Directive Format 


SKIP DIRECTIVE 

The SKIP directive repositions the named local file forward 
one or more system-logical records. A system-logical 
record (section for SCOPE 2) of level 17g or 
end-of-information terminates skipping. The SKIP 
directive format is shown in figure 3-38. 


•SKIP lfn,n 

Ifn Name of file to be positioned. 

n Number of logical records (sections for SCOPE 2) 
to be skipped in the forward direction. If n is 
omitted. Update skips one record (section). 


Figure 3-38. SKIP Directive Format 


INPUT STREAM CONTROL DIRECTIVES 

The input stream control directives allow the user to 
specify whether or not Update is to recognize abbreviated 
directives, delimit text, or control which input stream 
cards are to be displayed on the listing file. 


ABBREV DIRECTIVE 

The ABBREV directive causes checking for abbreviated 
directives to be resumed. It is usd in connection with the 
NOABBREV directive. The ABBREV directive format is 
shown in figure 3-39. 


•ABBREV 


Figure 3-39. ABBREV Directive Format 


ENDTEXT DIRECTIVE 

The ENDTEXT directive ends the condition established by a 
prior text directive. If ENDTEXT is encountered before 
TEXT, Update ignores it. The ENDTEXT directive format 
is shown in figure 3-40. Any information in columns 10 
through 256 is taken as a comment. 
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ENDTEXT 


•TEXT 


Figure 3-40. ENDTEXT Directive Format 

LIST DIRECTIVE 

The LIST directive causes listing of cards in the input 
stream to be resumed, it is used in connection with 
NOLIST. The LIST directive format is shown in figure 3-41. 


•LIST 


Figure 3-41. LIST Directive Format 


NOABBREV DIRECTIVE 

The NOABBREV directive causes Update to stop checking 
for the abbreviated forms of the directives. Update 
expands the name when it reads an abbreviated form so 
that it is a full name. The user has the option of not using 
abbreviations and of turning off the check through the 
NOABBREV feature. In this mode, an abbreviated 
directive is not recognized but is taken as text. The 
NOABBREV directive format is shown in figure 3-42. 


•NOABBREV 


Figure 3-42. NOABBREV Directive Format 

NOLIST DIRECTIVE 

The NOLIST directive disables list option 4. Update stops 
listing cards in the input stream when it encounters a 
NOLIST and resumes listing cards when it encounters a 
LIST. NOLIST directive format is shown in figure 3-43. 


•NOLIST 


Figure 3-43. NOLIST Directive Format 


LIST and NOLIST can occur anywhere in the input stream. 
They do not terminate insertion or a correction set. The 
LIST/NOLIST directives are ignored if list option 0 is 
selected. 


TEXT DIRECTIVE 

The TEXT directive, used in connection with ENDTEXT, 
causes all following card images to be treated as text, 
whether or not they begin with the master control 
character and would otherwise be considered as directives. 
When Update encounters a TEXT directive, the TEXT 
directive card image and all card images following it, up to 
and including the ENDTEXT directive, are considered as 
text and are written on the program library. A TEXT 
directive in the input stream must be either in a deck or in 
text being inserted. The TEXT and ENDTEXT directives 
are maintained on the program library as text card images; 
however, they are not written on the compile file. The 
TEXT format is shown in figure 3-44. Any information in 
columns 10 through 256 is taken as a comment. 


Figure 3-44. TEXT Directive Format 

SPECIAL DIRECTIVES 

The special directives provide extended features. With the 
exception of DEFINE and PULLMOD, they can appear any 
place in the input stream for creation or correction runs. 


DECLARE DIRECTIVE 

The DECLARE directive protects decks other than the 
declared deck from being inadvertently altered. 
Subsequent corrections are restricted to the named deck 
until Update encounters a DECLARE directive with no 
deck name or another DECLARE directive with a different 
deck name. This directive can only be used when the 
DECLKEY installation option has been assembled. The 
DECLARE directive format is shown in figure 3-45. 


•DECLARE deck 

deck Name of deck to which following corrections are 
restricted. 


Figure 3-45. DECLARE Directive Format 

When the DECLARE directive is encountered, the following 
restrictions go into effect: 

PURGE and YANK directives are illegal. 

INSERT, DELETE, RESTORE, and BEFORE directives 
can apply only to cards in the declared deck, if they 
do not, the operation is not performed and Update 
issues an informative message. 

Inserting or reactivating a DECK or COMDECK 
directive is illegal. 

New decks inserted via the ADDFILE directive need not be 
named in a DECLARE directive. 


DEFINE DIRECTIVE 

The DEFINE directive establishes a condition to be tested 
by the IF directive. The names on a DEFINE directive are 
unrelated to correction set identifiers or deck names. 
Update places DEFINE directives in the YANK$$$ deck. A 
DEFINE directive can be placed anywhere in a correction 
set. The DEFINE directive format is shown in figure 3-46. 


'DEFINE name1,name2, . . . ,namen 

name Name for subsequent testing by IF directive. 


Figure 3-46. DEFINE Directive Format 
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Figure 3-47 is deleted. 


LIMIT DIRECTIVE 

The LIMIT directive changes the maximum size for the 
listable output file from the default value of 6000 lines to 
the specified number of lines. It should be one of the first 
cards encountered in the input stream. The LIMIT 
directive will not appear in the new program library. The 
LIMIT directive format is shown in figure 3-48. 


*LIMT n 

n New line limit for listable output. 


Figure 3-48. LIMIT Directive Format 

When the specified limit is reached, options 3 (card image, 
deck name, and modification key) and 4 (input stream) are 
turned off. Errors and directives are still listed, however, 
if options 1 and 2 were selected. Options 5 through 9 are 
not affected. Refer to L parameter in section 4. 


PULLMOD DIRECTIVE 

The PULLMOD directive causes the program library to be 
searched for all card images belonging to each specified 
correction set and reconstructs a set of directives and 
text. The reconstructed correction set produces the same 
results as the original set. The search of the library is 


performed at the end of the Update run. Therefore, any 
modifications made by the current run are reflected in the 
PULLMOD results. Each reconstructed correction set is 
written to the file specified by the G parameter on the 
UPDATE control statement. All of the sets are contained 
within one system-logical record (section for SCOPE 2) on 
the file. The PULLMOD directive format is shown in 
figure 3-49. The PULLMOD directive can be used only 
when the PMODKEY installation option has been assembled 
for Update. 


•PULLMOD ident1,ident2, . . . ,identn 
ident Name of correction set to be re-created. 


Figure 3-49. PULLMOD Directive Format 

The user is responsible for determining whether or not the 
reconstructed correction sets accurately reflect the 
original corrections. PULLMOD is unable to determine if 
card images have been purged subsequent to the addition of 
the correction sets requested, 

A pullmod file has the same format as an input file. This 
feature permits a user to take an earlier version of the 
library and apply selected correction sets. 

/ COMMENT DIRECTIVE 

The / directive introduces a comment into the listable 
output file. Update ignores this card except to copy it to 
the listing file. A comment can appear at any place in the 
input stream. The slash can be redefined as another 
character through the / comment directive format is shown 
in figure 3-50. The slash must appear in column 2. 
Column 3 must be a comma or blank. 


*/ comment 


Figure 3-50. Comment Directive Format 
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UPDATE CONTROL STATEMENT 


4 


The Update utility is called by the UPDATE control 
statement. Parameters specify options and files for the 
run. The format of the call is shown in figure 4-1. The 
word UPDATE must begin in column one. See the 
operating system reference manual for additional control 
statement syntax requirements. 


UPDATE(p-list) 

p-list Parameters specifying options. Parameters in the 
list are separated by commas. A left parenthesis 
or a comma must separate the list from the word 
UPDATE. A right parenthesis or a period termin¬ 
ates the statement. 


Figure 4-1. UPDATE Control Statement Format 


PARAMETERS 

Ail Update parameters are optional and can appear in any 
order. The file specifying parameters (C,G,I,K,M,N,O f 
P,S,T) can be optionally followed by a digit, 6 or 8. The 
digit 6 forces the character set of the file to be in 6-bit 
display code and the digit B forces the character set to be in 
8-bit ASCII. However, Update uses ASCII only if the digit 8 
is used with the parameter on the Update control statement 
and if the input file uses ASCII characters. For example, 
C8=FILE specifies that the decks are to be written to the 
compile file named FILE using the ASCII character set. The 
6 and the 8 cannot both be specified at once for the same 
file. These ten parameters each have a default of either 
display code or ASCII, which can be overridden by using 
either the 6 or 8 digit (6 if the default is ASCII and 8 if the 
default is display code). M and P are exceptions? the 
character set is determined from the library's internal 
header. Parameters are summarized in table 4-1 and are 
described in detail below. 

A SEQUENTIAL-TO-RANDOM COPY 

This parameter copies a sequential old program library to a 
random new program library. No other Update operations 
are performed; any I parameter is ignored. The only other 
control statement parameters that can be used with the A 
| parameter are those specifying files, L=0, R, *, /, and H. 
An error results if the old program library is not sequential 
or the new program library is not random. For SCOPE 2, 
the new program library cannot be blocked. 

omitted No copy is made. 

A The sequential old program library is 

copied to a random new program library. 


B RANDOM-TO-SEQUENTIAL COPY 

This parameter copies a random old program library to a 
sequential new program library. No other Update 
operations are performed; any I parameter is ignored. The 
only other control statement parameters that can be used 
with the B parameter are those specifying files, L=0, R, *, 
and /. An error results if the old program library is not in 
random format. 


omitted 

No copy is made. 

B 

The random old program library is copied 
to a sequential new program library. 

C COMPILE FILE NAME 

This parameter specifies the name of the compile file. The 
content of the compile file is determined by the Update 
mode as shown in table 2-2. The default character set is 
display code. The C parameter is ignored. 

omitted or 
C or C6 
or C8 

Decks are written to the file named 
COMPILE. 

C=lfn 
or C6=lfn 
or C8=lfn 

Decks are written to file named lfn. 

C=PUNCH 

Decks are written to file named 
PUNCH. The D and 8 parameters are 
implied. 

c=o 

Compile file suppressed. 


The C parameter is ignored if K is also specified. 

D DATA WIDTH ON COMPLETE FILE 

This parameter specifies how many columns are to be used 
for data on the COMPILE file. Data width does not include 
sequencing information. 

omitted 72 columns of data to be used. 

D 80 columns of data to be used. 

E EDIT OLD PROGRAM LIBRARY 

This parameter specifies that the old program library is to 
be edited. During editing, the directory and deck list are 
rearranged to reflect the actual order of decks on the 
proqram library; all previously purged identifiers are 
removed. Identifiers that exist simply as entries in the 
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TABLE 4-1 SUMMARY OF UPDATE CONTROL STATEMENT PARAMETERS 


J. 

Parameter 

Function 

A 

Copy sequential old proqram library to new random program library. 

B 

Copy random old program library to new sequential old proqram library. 

C 

Specify name of compile file. 

0 

Define compile file line image width excluding Update sequence information. 

E 

Remove from directory previously purged identifiers and purge identifiers that exist simply 


as directory entries. 

F 

Select full Update mode. 

G 

Specify name of pu11 mod file. 

H 

Override old program library character set. 

1 

Specify name of file with input stream. 

K 

Write decks on compile file in order specified on COMPILE directives. 

L 

Select listable output file contents. 

M 

Merge specified program library with old program library. 

N 

Specify name of new program library file. 

0 

Specify name of listable output file; content is determined by L parameter. 

P 

Specify names of old proqram library and secondary old proqram libraries. 

Q 

Select quick update mode. 

R 

Specify particular files to rewind. 

5 

Specify name of source file; content includes common decks and is determined by mode. 

T 

Same as S, but omit conmon decks. 

U 

Do not terminate execution if fatal error occurs. 

U 

Specify sequential new program library file. 

X 

Specify compressed format for compile file. 

8 

Define compile file line image width including Update sequence information. 

» 

Redefine master control character for directives. 

' 

Redefine control character for comments. 

"^Parameters C, G, I, K, M, N, 0, p, S, and T can be appended with 6 {for display code) or 8 (for 

ASCII). 


directory aid have no cards associated with them are 
purged. Any cards other than YANK, SELYANK, 
YANKDECK or DEFINE that exist in the YANK$$$ deck 
are also purged. 


Two edit runs are required to edit the library completely. 
The first edit run removes purged identifiers and flags 
unused identifiers as purged. The second edit run deletes 
the unused identifiers from the directory. 

omitted No editing is done. 

E The program library is edited. 


The E parameter can only be used when the EDITKEY 
installation option has been assembled for Update. 


F FULL UPDATE MODE 

This parameter specifies full Update mode. 

omitted Normal selective Update mode, as long 

as Q is not specified. 

F Full Update mode. 


G PULLMOD FILE NAME 

This parameter specifies the name of the pullmod file. The 
default character set is display code. The G parameter can 
only be used when the PMODKEY installation option has 
been assembled for Update. 

omitted Output from PULLMOD directives is 
appended to the source file 
(S parameter). 
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G=lfn 
or G6=lfn 

or G8=lfn Output from PULLMOD directives is 
written on file named lfn. The listable 
output file (O parameter) cannot be 
specified. 


K=lfn 
or K6=ifn 

or K8=Ifn Compile output decks to be written on 
file named lfn in COMPILE directive 
sequence. 


H CHARACTER SET CHANGE 

This parameter allows the user to override the character 
set type specification in the old program library. 

omitted 

or H Update treats the old program library 

character set as the character set 
indicated in the old program library. 

H=3 Update treats the old program library as 

a 63-character set program library 
regardless of the character set specified 
in the old program library. 

H=4 Update treats the old program library as 

a 64-character set program library 
regardless of the character set specified 
in the old program library. 

I INPUT STREAM FILE NAME 

This parameter specifies the name of the primary input 
file. The default for this parameter determines the input 
file character set by examining the first line image. Direct 
input from terminals default to the ASCII character set if 
the input file uses ASCII and if 16 is not specified on the 
UPDATE control statement. All auxiliary input files must 
be in the same character set as the primary input file. 
Input lines are read and stored up to 256 characters in 
length. No special parameter is necessary to use long 
lines. Lines exceeding 256 characters are truncated and an 
informative message is issued. 


L LISTABLE OUTPUT OPTIONS 

This parameter specifies the content of the output file. 

omitted For a creation run, selects options A, 1, 
and 2. 

For a correction run, selects options A, 
1, 2, 3, and 4. 

For a copy run, selects options A and 1. 

L=c...c Each character in string c...c selects one 

of the following options. The character 
0 overrides any other options specified 
and suppresses the entire listing. 

A List known deck names and 

correction set identifiers (deck 
names and correction set identifiers 
must be on the primary old program 
library to be known), COMDECK 
directives that were processed, 
known definitions (DEFINE 

directive), and decks written to the 
compile file. 

F All options except 0. 

0 All listing is suppressed. 

X List cards in error and the 

associated error messages. The flag 
*ERROR* appears to the left and 
right of an erroneous card image. 


omitted or 
I or 16 

or 18 Directives and text are on the file named 

INPUT. 

I=Ifn 
or I6=lfn 

or I8=lfn Directives and text are on file named lfn. 


K COMPILE FILE SEQUENCE 

This parameter specifies that decks are to be written to 
the compile file in the order in which the deck names are 
encountered on COMPILE directives. If a deck name is 
mentioned more than once, its last specification 

determines the deck’s place within the compile file. The 
| default character set is display code (K6). This parameter 
takes precedence over the C parameter. 

omitted Location determined by C parameter. 


2 List all active Update directives 
encountered either on the input file 
or on the old program library. Those 
directives encountered in input are 
flagged with five asterisks to the 
left unless the directive is 
abbreviated or the card identifier is 
in short form. In this case, the 
directive is flagged with five 
slashes. If the directive has been 
encountered on the old program 
library, the name of the deck to 
which this card belongs is printed in 
place of the five asterisks or slashes. 

3 Comment on each card that changed 
status during current run. 
Comments include the deck name, 
card image, card identifier, and an 
indicator of action taken for that 
card. 


K or K6 Decks to be written to the file named 
COMPILE in COMPILE directive 
sequence. 


1 Card added. 

A Inactive card reactivated. 
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D Active card deactivated. 

P Card purged. If the card 

was active, ACTIVE also 

appears. 

SEQ Card resequenced. 

4 List text cards encountered in the 
input stream. Cards read as a result 
of a READ directive are identified 
to the right with the file name. 
Cards inserted as a result of an 
ADDFILE directive are listed only 
when option 4 is explicitly selected. 
Cards inserted as a result of a 
COPY directive are identified to the 
right by the word copy. 

Option 4 can be turned on by a LIST 
directive and off by a NOL15T 
directive. 

5 List all active compile file 
directives. 

6 List number of active and inactive 
cards by deck name and correction 
set identifier. 

7 List all active cards; identify to the 
right with an A. 

8 List all inactive cards; identify to 
the right with an I. 

9 List correction history of all cards 
selected by list options 5, 7, and 8. 

List options 5 through 9 are provided for auditing an old 
program library. These options are available only when the 
AUDITKEY installation option is assembled. Output is 
written to a temporary file and appended to the listable 
output file at the end of the Update run. When the F 
parameter is selected, options 5 through 9 apply to all 
decks on the old program library. If F is not selected, 
options 5 through 9 apply to decks listed on COMPILE 
dirctives only. 

If the old program library is sequential and F is not 
selected, called common decks that precede the decks that 
call them must be explicitly named on COMPILE directives 
to be audited. A common deck is audited automatically if 
it follows the deck that calls it. If the old program library 
is random, called common decks are audited automatically. 


N NEW PROGRAM LIBRARY FILE NAME 

This parameter specifies the name of the new program 
library. The default character set is ASCII if the P, M, or I 
file uses ASCII. 


omitted Suppress new program library generation 
if correction run, otherwise write new 
program library to file named NEWPL. 

N or N6 

or N8 Write new program library to filenamed 

NEWPL. 


N=lfn 
or N6=lfn 

or N8=Ifn Write new program library to filenamed 
Ifn. 


O LISTABLE OUTPUT FILE NAME 

This parameter specifies the name of the output file. 
Output file content is determined by the L parameter. 

omitted or 
0 or 06 

or 08 Write output to file named OUTPUT. 

0=lfn 
or 06=lfn 

or 08=lfn Write output to file named Ifn. 


P OLD PROGRAM LIBRARY FILE NAME 

This parameter specifies the name of the old program 
library; it is ignored on a creation run. The default 
character set is determined from the header. 


omitted 

or P 

Old program library 
named OLDPL. 

resi des 

on file 

P=lfn 

Old program library 
named Ifn. 

resides 

on file 

P=lfn/sl/ 

s2/.../s7 

Old program library resides on 
Ifn. Secondary old program 

filenamed 

libraries 


reside on files si, s2,...,s7. 

P=/sl/s2/ 

.../s7 Old program library resides on file 

OLDPL. Secondary old program libraries 
reside on files si, s2,...,s7. 


M MERGE PROGRAM LIBRARIES 

This parameter merges two program libraries as one new 
program library. The M parameter is ignored on a creation 
run. The two program libraries must be in the same 
character set. The default character set is determined 
from the header. 


omitted 

No merge file. 


M 

Program library to be 
old program library is on 

merged with the 
file MERGE. 

M=lfn 

Program library to be merged with old 
program library on file named Ifn. 


Q QUICK UPDATE MODE 

This parameter specifies quick Update mode. It takes 
precedence when both F and Q are specified. 

omitted When F is also omitted, normal selective 

Update mode. 

Q Quick mode. 

Corrections other than ADDFILE that reference cards in 
decks not specified on COMPILE directives are not 
processed in quick mode and Update abnormally terminates 
after printing the unprocessed corrections. 
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In Q mode, using a random old program library, a single 
correction set containing corrections to both a DECK and a 
COMDECK may cause trouble if the COMDECK logically 
precedes the DECK on the old program library. No errors 
will be detected, but if the same run is repeated with the N 
parameter specified on the UPDATE control statement 
and/or the old program library is sequential, the sequence 
numbers assigned to the text cards in the correction set 
will not be the same as they were in the Q mode run. This 
situation cannot be prevented without sacrificing the speed 
for which Q mode was designed. The correct sequence 
numbers are those assigned when N is specified or the old 
program library is sequential. 


T=lfn 
or T6=lfn 

or T8=lfn Source output to be written on file 
named lfn, with common decks excluded. 


U DEBUG HELP 

The U parameter does not prevent Update from proceeding 
to pass 2 (correction phase) if errors are encountered in 
pass 1 (read-input-stream phase). The user should be aware 
that because of the method in which Update works, pass 1 
errors could conceivably cause the flagging of pass 2 items 
which are not errors. 


R REWIND FILES 

This parameter specifies files to be rewound before and 
after an Update run. 

omitted Rewind the old program library, the new 
program library, the compile file, the 
source file, and the pullmod file. 


omitted Update execution terminates when a 
fatal error is encountered. 

U Update execution is not terminated by a 

fatal error. 


W SEQUENTIAL NEW PROGRAM LIBRARY FORMAT 


R Do not rewind any files. 

R=c...c Each character in the string indicates a 
file to be rewound. The characters also 
apply to corresponding two-character 
control statement options. 


This parameter specifies that the new program library is to 
have sequential format. 

omitted New program library format is 
determined by file residence as shown in 
table 2-3. 


C Compile 


W New program library is a sequential file. 


N New program library 

P Old program library and merge 
library 

S Source and pullmod 


S SOURCE FILE NAME 

This parameter specifies the name of the source file. The 
content of the source file is determined by the mode in 
which Update is operating, by the decks named on 
COMPILE directives, and by the format of the old program 
library in use (random or sequential). 

omitted Suppress source output file unless it is 
selected by the T parameter. 

S or S6 

or S8 Source output file to be written on file 

named SOURCE. 

S=lfn 

or S6=lfn 

or S8=lfn Source output file to be written on file 
named lfn. 


T OMIT COMMON DECKS FROM SOURCE FILE 


This parameter specifies that common decks are to be 
excluded from the source file. It takes precedence over 
the S parameter. 


omitted 


T or T6 
or T8 


Suppress source file unless it is selected 
by the S parameter. 


X COMPRESSED COMPILE FILE 

This parameter specifies that the compile file is to be 
compressed. 

omitted Compile file is not written in compressed 
format. 

X Compile file is written in compressed 

format (appendix D). 


8 CARD IMAGE WIDTH ON COMPILE FILE 

This parameter specifies total card image width on the 
compile file including sequencing information (appendix D). 


omitted 

Compile file output is 
90-column card images. 

composed 

8 

Compile file output is 
80-coiumn card images. 

composed 

MASTER 

CONTROL CHARACTER 



This parameter specifies the master control character. If 
the character specified for a correction run is not the same 
as the character used when the old program library was 
created, the old program library character is used. 

omitted The first character of each directive is *. 

*=c The first character of each directive for 

this Update run is cj c can be any 
character A through Z, 0 through 9, or + 
• * / $ or s. (The $ character should be 
specified as *=$$$$ or /=$$$$.) 
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/ COMMENT CONTROL CHARACTER 


selects the following default values: 


This parameter specifies the comment control character. 


C=COMPILE 


omitted Comment control character is /. 


G=SOURCE (correction run) 


/ =c The comment control character is c; c 

can be any character A through Z, 0 
through 9, or + - * / $ or =. (The $ 
character should be specified as *=$$$$ 
or /=$$$$.) Note, however, that the 
character should not be changed to one 
of the abbreviated forms of a directive 
unless NOABBREV is in effect. 

I UPDATE CONTROL STATEMENT 
EXAMPLES 

The update control statement 

UPDATE(C=0,I=IN,L=F,N=TEST2,P=TEST1,S,*=+) 

selects the following options in addition to default values 
for the omitted parameters: 

C=0 A compile file is not generated. 

I=1N The input stream is on the file named IN. 

L=F A full output listing is generated. 

N=TEST2 A new program library named TEST2 is 
generated. 

P=TEST1 The old program library is on the file 
named TEST1. 


MNPUT 

L=A,1,2 (creation run) 

A,1,2,3,4 (correction run) 

N=NEWPL (creation run) 

O^OUTPUT 

R=C,N,P,S 

P=OLDPL (correction run) 

*_* 

1=1 

In addition, the following defaults apply: 

The compile file has 90 columns with 72 columns for 
data. 

No editing is performed. 

Update mode is normal selective. 

The character set used is that specified in the library 
header. 

No merging is performed. 


S A source file is generated on file named 

SOURCE. 

*=+ The master control character is +. 


Execution is terminated if a fatal error occurs. 

New program library file format is determined by file 
residence. 


The UPDATE control statement: 


The compile file is not in compressed format. 


UPDATE(C=0,I=0,N8=NUPL8,S) 


The UPDATE control statement 


selects the following options: 


UPDATE(P=0LDPL8,S8,I,0,N6=NUPL6) 


N8=NUPL8 An 8-bit (ASCII) NEWPL is generated if 
an ASCII old program library or some 
ASCII data is input. 

C=0 A compile file is not generated. 

1-0 The 0 is an empty file; no corrections are 

applied. 


S 


A source file in display code named 
SOURCE is generated. 


The update control statement 
UPDATE(A,N=RAN,P=SEQ) 

causes Update to copy the sequential old program library, 
SEG, to a random new program library named RAN. The L, 
O, *, and / parameters assume their default values. No 
other parameters are applicable when A is specified. 


The UPDATE control statement 


UPDATE. 


selects the following values: 

P=OLDPL8 Modify the program library named 
OLDPL8; the program library is assumed 
to be in ASCII. 

S8 Generates an ASCII source file named 

SOURCE. The source file is in ASCII 
code if the old program library is in 
ASCII code. 

I The input is in ASCII or display code on 

the file named INPUT. Update 
automatically determines the character 
set of the input file. 

O The output is in display code (the 

default) on the file named OUTPUT. 

N6=NUPL6 Causes Update to generate a new 
program library in display code from the 
old program library in ASCII code on the 
file named NUPL6. 
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EXAMPLES OF UPDATE RUNS 


5 


This section contains several examples of Update runs. The 
| directives illustrated include PURGE, YANK, ADDFILE, 
and PULLMOD. Examples also show how to save or store a 
program library as a permanent file under the various 
operating systems. Also included in this section is an 
example of a FORTRAN program maintained as a program 
library. 


LBRARY FILE CREATION 

Figure 5-1 shows an example of an Update creation run in 
which several COMPASS and FORTRAN routines become a 
program library. The UPDATE control statement indicates 
a new library is to be created with the name PL. Since no 
other parameters are specified, Update uses default values. 


job statement 


UPDATE(N=PL) 

7/8/9 

•DECK COMGROUP 
COMPASS program 
•DECK COMGROUP1 
COMPASS program 
*WEOR 

*DECK FORGROUP 
FORTRAN program 
‘DECK FORGROUP1 
FORTRAN program 

6/7/8Z9 


Figure 5-1. Update Creation Run 

Since the first directive encountered is DECK, Update 
recognizes a creation run and begins construction of a new 
program library. All cards following the first DECK 
directive, up until the second DECK directive, are written 
as a deck with the name COMGROUP. The first card is 
assigned the identifier COMGROUP.2, the next 
COMGROUP.3, and so forth. (The DECK directive itself is 


also a part of 
COMGROUP. 1.) 

the 

library 

and has 

the identifier 

A new deck, 

with 

card 

identifiers 

in the form 


COMGROUPl.n, beains when Update encounters the second 
DECK directive. In this example (figure 5-1), two 
COMPASS programs form the first two decks; COMGROUP 
and COMGROUP1; and two FORTRAN programs make up 
the last two decks (FORGROUP and FORGROUP1). At the 
end of the Update run, a program library exists with four 
decks. 

The compile file produced by the run in figure 5-1 contains 
two system-logical records as a result of the WEOR 
directive. All four decks are written to the compile file. 
It has the default name of COMPILE. 


The example in figure 5-2 shows a creation run in which 
directives are read from the alternate input file 
REMTAPE. Update reads text and directives from 
REMTAPE until the end of the system logical record 
(end-of-section for SCOPE 2) is encountered. Update then | 
resumes reading from the main input file, INPUT. The 
resulting new program library contains decks A, B, C, and 
LOCAL. 


A. 

Update Job Deck. 


job statement 


UPDATE(N) 


7/8/9 

•READ REMTAPE 
•DECK LOCAL 
text of LOCAL 

6/7/8/9 

B. 

Contents of REMTAPE 


•DECK A 
text of A 
•DECK B 
text of B 
•DECK C 
text of C 


Figure 5-2. Creation of Library From Alternate Input File 

The program library, NEWPL, created by the example in 
figure 5-3 contains four decks; two of them are common 
decks. The compile file that is produced by default 
contains decks XA and XB in that order. Deck XB is 
expanded by Update to contain common deck D2 on the 
compile file. 


job statement 


UPDATE(N) 


7/8/9 

‘COMDECK D1 
text of D1 
•COMDECK 02 
text of D2 
‘DECK XA 
text of XA 
•DECK XB 
text of XB 
•CALL D2 
6/7/8Z9 


Figure 5-3. Creation of Library With Common Decks 
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INPUT FILE NOT INPUT 


Text and directives do not have to be part of the job deck. 
They can be in a file specified by the 1 parameter of the 
UPDATE control statement. In figure 5-4, Update creates 
a program library from information contained in file Al. 
The library that is produced contains three decks having 
cards identified by their deck name and sequence number 
as shown in figure 5-5. 


A. Update Job Deck 
job statement 


UPDATE(I=A1, N) 


6/7/S/9 

B. Contents of AI 

'COMDECK CSET 

COMMON A,B,C 

'DECK SET1 

PROGRAM ZIP 

C A DO-NOTHING JOB 

STOP 
END 

'DECK SET2 

SUBROUTINE JIM 
A = B - SIN(C) 
RETURN 
END 


■ - ■" 1 

Figure 5-4. Input File Not INPUT 

'COMDECK CSET 

CSET.1 

COMMON A,B,C 

CSET.2 

'DECK SET1 

SET1.1 

PROGRAM ZIP 

SET1.2 

C A DO-NOTHING JOB 

SET1.3 

STOP 

SET1.4 

END 

SET1.5 

'DECK SET2 

SET2.1 

SUBROUTINE JIM 

SET2.2 

A = B - SIN(C) 

SET2.3 

RETURN 

SET2.4 

END 

SET2.5 


Figure 5-5. Program Library Contents 


| INSERTING,DELETING, AND COPYING 

The Update run illustrated in figure 5-6 modifies the decks 
SET1 and SET2 of the program library created by the run in 
figure 5-4. As a result of the correction run, SET1 appears 
in the compile file as shown in fiqure 5-7. 

Figure 5-0 shows the modification of an old program library 
named FN and the production of an assembly listinq. The 
compile file that is read by COMPASS contains deck XA 
after that deck was modified by Update. 


job statement 


UPDATE(N.F) 


7/8/9 

'IDENT ADD1 
'DELETE SET1.3, SET2.5 
'CALL CSET 
B-1.0 
C=3.14159 
CALL JIM 

'COPY SET1, SET1.4, SET1.5 
'COPY SET2, SET2.2 
'CALL CSET 

'COPY SET2, SET2.3, SET2.5 
6/7/8/9 


■ 

Figure 5-6. 

1 

Modify Old Program Library 

PROGRAM ZIP 

SET1.2 

COMMON A,B,C 

CSET.2 

B=1.0 

ADD1.2 

C=3.14159 

ADD1.3 

CALL JIM 

ADD1.4 

STOP 

ADD1.5 

END 

ADD 1.6 

SUBROUTINE JIM 

ADD1.7 

COMMON A,B,C 

CSET.2 

A = B - SIN(C) 

ADD1.9 

RETURN 

ADD1.10 

END 

ADD1.11 


Figure 5-7. Compile File Contents 


job statement 


UPDATE|P=FN) 


COMPASS! I=COMPI LE) 


7/8/9 

'IDENT CS1 
'INSERT XA.1 
Insertions 

'DELETE XA.20, XA.23 
6/7/8Z9 


Figure 5-8. Correction Run 
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PURGING AND YANKING 


The purge directives differ from the yank directives in that 
yank operations are temporary; cards yanked from the 
program library are temporarily deactivated. The cards 
can be reactivated by a subsequent yank of the yank 
directive that deactivated the card images. 

In contrast, any change made to a program library through 
a purge directive is permanent. A reversal of a purge 
operation is possible only through the reintroduction of the 
cards into the library as if they had not previously existed. 

The YANK directive in figure 5-9 becomes the first card 
on the new program library. The identifier for this card is 
NEGATE.l. The effects of the YANK can be nullified in 
future runs (consequently the effects of the correction set 
GOTTOGO are restored) by specifying the following: 

♦1DENT RESTORE 
♦DELETE NEGATE.l 

or * ID ENT RESTORE 
♦YANK NEGATE 

or *PURGE NEGATE 


I 


job statement 


UPDATE(P=LIB,N=NEWLIB) 


7/8/9 

* IDENT NEGATE 
*YANK GOTTOGO 
6/7/8/9 


Figure 5-9. Use of YANK 


job statement 


UPDATE{N=LI BMAY,P=LI BAUG,C=0) 


7/8/9 

•PURGE JUNMOD1,* 
6/7/B/9 


Figure 5-10. Return to Previous Level 


job statement 


UPDATE (P= LI B,N=N EWB AD,C=0) 


7/8/9 

'PURDECK BAD 
6/7/B/9 


Figure 5-11. Use of PURDECK 

As a means of comparing the effects of YANK, SELYANK, 
and YANKDECK, consider the following: 

♦YANK OLDMOD 

This directive causes all effects of the correction set 
OLDMOD on the entire library to be nullified. Card 
images introduced by OLDMOD are deactivated; card 
images deactivated by OLDMOD are reactivated. 

♦SELYANK OLDOECK.OLDMOD 


If the correction set NEGATE contained other corrections 
as well as the YANK, the YANK could be permanently 
removed by specifying the following: 

♦SELPURGE YANK$$$.NEGATE 


This directive accomplishes the same effect as the 
♦YANK OLDMOD directive except its effect is limited | 
to card images within the deck OLDDECK. 

♦YANKDECK OLDDECK 


or it could be temporarily removed by specifying: 

♦SELYANK YANK$$$.NEGATE 

The Update run in figure 5-10 returns a program library to 
a previous level. The program library LIBAUG was 
modified periodically over a number of months. LIBAUG is 
the most recent (August) version of the program library. 
This run re-creates a library modified only through May. 
The run purges all modifications made after May (beqiming 
with JUNMOD1 in the directory). 

The run in figure 5-11 permanently removes deck BAD 
from the library. LIB is the most recent program library. 
NEWBAD is the new program library with BAD purged. 
♦PURDECK BAD operates so that any cards having the 
identifier BAD but physically located outside of the deck 
BAD are not purged. 


This directive affects all card images in OLDDECK, 
without regard to which correction set they belong. 

The effects of the purge directives PURGE, SELPURGE, 
and PURDECK work the same as the yank directives 
except the results are permanent. 

SELECTIVE YANKING 

The text stream in figure 5-12 illustrates the use of the DO 
and DONT directives. The deck ZOTS had contained cards 
introduced by the correction set DART; a later correction 
set contained a YANK directive that yanked correction set 
DART. The user wishes to nullify a portion of the YANK 
directive that affects the cards following ZOTS.19 through 
ZOTS.244; all other cards belonging to the correction set 
DART are to remain yanked. Inserting a DO at ZOTS.19 
and a DONT at ZOTS.244 causes Update to rescind the 
YANK directive while writing the deck ZOTS to the 
compile file. 
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•IDENT 

REST 

•INSERT 

ZOTS.19 

O 

D 

DART 

•INSERT 

ZOTS.244 

•DONT 

DART 


Figure 5-12, Use of DO and DO NT 


SELECTIVE WRITING TO COMPILE FILE 

During the correction phase Update processes the following 
directive: 

♦DEFINE ABC 

I It is automatically placed in the YA NK$$$ deck (*INSERT 
is not needed). PROG2, a deck to be written on the 
compile file, contains the following sequences 

♦DECK PROG2 


*F DEF,ABC 


♦ENDIF 

Since ABC is defined, all active cards between the IT and 
ENDIF pair are written as part of PROG2. Removing the 
DEFINE from the YANK$$$ deck would cause these text 
cards to be skipped. 

The input stream in figure 5-13 has mutually exclusive 
requirements depending on the availability of correction 
set IDC. If IDC is known, the first 15 active cards after 
the first IF are written to the compile file. If IDC is not 
known, the cards following the second IF through the 
EhflDIF are written to the compile file. 


•DECK DECKA 


*IF IDENT,IDC,15 
*1F - IDENT.IDC 
active text cards 
*ENDIF 


Figure 5-13. Use of IF and ENDIF 

Nesting of F directives is illustrated in fiqure 5-16. The 
deck ROCK has an IF-controlled sequence containing a 
second F-controlled sequence. The text following the first 
F is written if PEBBLE is known (on the old program 
library); the text following the second F is written if both 
PEBBLE and STONE are known. The ENDIF terminates 
both F-controlled sequences. 


•DECK ROCK 


*!F IDENT,PEBBLE 


*1F IDENT,STONE 


*ENDIF 


Figure 5-14. Nested IF Directives 


ADDITION OF DECKS 

A new program library, NEWPL, is to be constructed from 
the old program library, OLDPL, with the addition of one 
new common deck and two new decks. The new common 
deck, D1A, will be the first deck after the YANK$$$ deck; 
the new deck XC will follow deck SX; and the new deck 
SYSTEXT will be the last deck on the new program library. 
No compile file will be produced. All three of the 
ADDFILEs in figure 5-15 are to be read from the main 
input file INPUT. The ADDFILEs in figure 5-16 are to be 
read from the Update input file FNAME. In both these 
cases, the input file need not be specified but the two 
separators must be included (either space and comma or 
two commas). Each of the ADDFILE directives in 
figure 5-17 will cause Update to read from a separate file 
that is not the main input file. Common deck D1A and its 
text are on FILEA; deck SYSTEXT and its text are on 
FILEB; deck XC and its text are on FILEC. 


job statement 


UPDATE(N,C=0) 


7/8/9 

•ADDFILE INPUT, YANK$$$ or *ADDFfLE„ YANK$$$ 
•COMD6CK OTA 


•ADDFILE INPUT or 'ADDFILE 
•DECK SYSTEXT 


•ADDFILE !NPUT,XB or * ADDFILE „XB 
•DECK XC 


6/7/8Z9 


Figure 5-15. ADDFILE Input on File INPUT 
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A. Update Run 
job statement 


UPDATE|N,C=0,!=FNAME> 


6/7Z8/9 

B. Contents of file FNAME 

•ADDFILE FNAME, YANK$S$ or *ADDFILE„YANK$$$ 
'COMDECK D1A 


‘ADDFILE FNAME or 'ADDFILE 
•DECK SYSTEXT 



The Update run in figure 5-19 re-creates the correction set 
that changed SET1; the file PMFILE contains the following 
re-created correction set: 

•IDENT PMEX 

♦DELETE 5ET1.3,SETi,3 

C THIS IS FOR PULLMOD EXAMPLE 


job statement 


UPDATE<G-PMFtLE, P=PL2i 
7/8/9 

•PULLMOD PMEX 
S/7/8/9 


'ADDFILE FNAME,X8 or *ADDFILE„X8 
'DECK XC 


Figure 5-16. ADDFILE Input on File FNAME 


job statement 


Figure 5-19. Pull Modifications 

PROGRAM LIBRARY AS A 
PERMANENT FILE 

The job deck in figure 5-20 illustrates the creation and 
saving of a program library as a permanent file under 
N05/BE and SCOPE 2; the deck in figure 5-21 saves a 
program library as an indirect access file under NOS. See 
the appropriate operating system reference manual for 
additional details. 


UPDAT£{N,C=0) 


7/8/9 

•ADDFILE FILEA,YANKSSS 
•ADDFILE FILEB 
•ADDFILE FILEC,X8 
6/7/8Z9 


job statement 

accounting statements 

REQUEST(PL,*PF) 

UPDATE(N=PL,W,L=1234) 

CATALOG [PL.PLIB, I D=JONES) 

7/8/9 

•DECK ONE 


6/7/8/9 


Figure 5-17. ADDFILE Input on Secondary Input Files 

PULLMOD OPTION 

The program library created by the example in figure 5-4 
| {Input File Not INPUT) has been altered by the correction 
run in fiqure 5-18. As a consequence of the run, the deck 
SET1 contains the following cards: 

•DECK SET1 

PROGRAM ZIP 

C THIS IS FOR PULLMOD EXAMPLE 

STOP 
END 


job statement 


Figure 5-20. Permanent File Under NOS/BE or SCOPE 2 


job statement 
accounting statements 
UPDATE (N=PL,W, 1=1234) 
SAVE{PL=UPLIB). 

7/8/9 

•DECK ONE 


6/7/8/9 


Figure 5-21. Permanent File Under NOS 


UPDATE (N=PL2) 


7/8/9 

•IDENT PMEX 
•DELETE SET1.3 

C THIS IS FOR PULLMOD EXAMPLE 

•COMPILE SET1 

6/7/8Z9 


Figure 5-18. Correction Run for PULLMOD Example 
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| SAMPLE FORTRAN PROGRAM 

This set of Update examples illustrates how Update can be 
| used for maintaining a FORTRAN program in program 
library format. The FORTRAN program calculates the area 
of a triangle obtaining the base and height from the data 
record. 

The job in figure 5-22 places the FORTRAN program and 
subroutine as a single deck (ONE) on the new program 
library (NEWPL) and on the compile file (COMPILE). 
| Following Update execution, FTN5 is called to compile the 
program; the source is on the COMPILE file. LGO calls for 
execution of the compiled program. This program does not 
execute because of an error in the SUBROUTINE 
statement. The name of the subroutine should be MSG, not 
MSA. 


job statement 


UPDATE(N.F) 

FTN(l=COMPILE) 

LGO. 


7/8/9 

’IDENT MODI 
•DELETE ONE.20 

SUBROUTINE MSG 

7/8/9 

data 

6/7/8/9 



Figure 5-22. FORTRAN Program Library - 1 

Examination of update output from the creation job reveals 
that the erroneous SUBROUTINE statement has card 
identifier ONE.20. The job in figure 5-23 corrects the error 
and generates a new program library. 

The job in figure 5-24 uses the same input as the job in 
figure 5-22. However, the program in figure 5-24 is divided 
into two decks, ONE and MSG. Deck MSG is a common 
deck. A CALL directive is inserted into deck ONE to assure 
that whenever deck ONE is written on the compile file, MSG 
is also written on the compile file. 


Figure 5-23. Correction of SUBROUTINE Statement 


job statement 


UPDATE(N;F) 

FTN5(!=COMPILE) 

LGO. 


7/8/9 

•COMDECK MSG 

SUBROUTINE MSG. 

PRINT 400 

400 FORMAT(///,’ FOLLOWING INPUT DATA 

(NEGATIVE OR ZERO’) 

RETURN 

END 

•DECK ONE 

PROGRAM ONE(INPUT,OUTPUT,TAPED 
PRINT 5 

5 FORMATOHD 

10 READ (*,100,END=120)BASE,HEIGHT 

100 FORMAT (BZ,2F10.2,I1) 

IF (BASE.LE.0) GO TO 105 
IF (HEIGHT.LE.O) GO TO 105 
GO TO 106 
105 CALL MSG 



Figure 5-24. FORTRAN Program Library - 2 
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The example in figure 5-25 adds a deck to the library 
created in the previous example (figure 5-24). Since no 
new program library is generated (N is omitted from 
Update call), the addition is temporary. 


job statement 


UPDATE. 

FTN(!=COMPILE) 

LGO. 


7/8/9 

•IDENT MOD2 
•INSERT ONE.20 
•OECK TWO 

PROGRAM TWO(INPUT.OUTPUT) 


END 

•CALL MSG 
•DELETE MSG.3 

400 FORMAT!///, 'FOLLOWING INPUT DATA 
POSITIVE') 

7/8/9 

data 

6/7Z8/9 


Figure 5-25. Add Deck to FORTRAN Program Library 
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STANDARD CHARACTER SET 


A 


| Control Data operating systems offer the following 
variations of a basic character set: 

• CDC 64-character set 

• CDC 63-character set 

• ASCII 64-character set 

• ASCII 63-character set 

The set in use at a particular installation was specified 
when the operating system was installed. 

Depending on another installation option, the system 
assumes an input deck has been punched either in 026 or in 
029 mode (regardless of the character set in use). Under 
NOS/BE, the alternate mode can be specified by a 26 or 29 


punched in columns 79 and 80 of the job statement or any 
7/8/9 card. The specified mode remains in effect 
throughout the job unless it is reset by specification of the 
alternate mode on a subsequent 7/8/9 card. 

Under NOS, the alternate mode can be specified by a 26 or 
29 punched in columns 79 and 80 of any 6/7/9 card, as 
described above for a 7/8/9 card. In addition, 026 mode 
can be specified by a card with 5/7/9 multipunched in 
column 1; 029 mode can be specified by a card with 5/7/9 
multipunched in column 1 and a 9 punched in column 2. 

Graphic character representation appearing at a terminal 
or printer depends on the installation character set and the 
terminal type. Characters shown in the CDC graphic 
column of the standard character set (table A-l) are 
applicable to BCD terminals; ASCIf graphic characters are 
applicable to ASCII-CRT and ASCII-TTY terminals. 
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A-l 


TABLE A-l. STANDARD CHARACTER SETS 




CDC 



ASCII 


Display 

Code 

(octal) 

Graphic 

Hollerith 

Punch 

(026) 

External 

BCD 

Code 

Graphic 

Subset 

Punch 

(029) 

Code 

(octal) 

00 1 

: (colon) TT 

82 

00 

: (colon) ** 

8-2 

072 

01 

A 

12-1 

61 

A 

12-1 

101 

02 

B 

12-2 

62 

B 

12-2 

102 

03 

C 

12-3 

63 

C 

12-3 

103 

04 

D 

12-4 

64 

D 

12-4 

104 

05 

E 

125 

65 

E 

12-5 

105 

06 

F 

12-6 

66 

F 

12-6 

106 

07 

G 

12-7 

67 

G 

12-7 

107 

10 

H 

12-8 

70 

H 

12-8 

110 

11 

1 

12-9 

71 

1 

12-9 

111 

12 

J 

11-1 

41 

J 

11-1 

112 

13 

K 

11-2 

42 

K 

11-2 

113 

14 

L 

113 

43 

L 

11-3 

114 

15 

M 

11-4 

44 

M 

11-4 

115 

16 

N 

11-5 

45 

N 

115 

116 

17 

O 

11-6 

46 

O 

11-6 

117 

20 

P 

11-7 

47 

P 

11-7 

120 

21 

Q 

11-8 

50 

Q 

11-8 

121 

22 

R 

11-9 

51 

R 

11-9 

122 

23 

S 

0-2 

22 

S 

0-2 

123 

24 

T 

0-3 

23 

T 

0-3 

124 

25 

U 

0-4 

24 

U 

0-4 

125 

26 

V 

05 

25 

V 

0-5 

126 

27 

w 

0-6 

26 

w 

0-6 

127 

30 

X 

0-7 

27 

X 

0-7 

130 

31 

Y 

0-8 

30 

Y 

0-8 

131 

32 

z 

0-9 

31 

z 

0-9 

132 

33 

0 

0 

12 

0 

0 

060 

34 


1 

01 

1 

1 

061 

35 

2 

2 

02 

2 

2 

062 

36 

3 

3 

03 

3 

3 

063 

37 

4 

4 

04 

4 

4 

064 

40 

5 

5 

05 

5 

5 

065 

41 

6 

6 

06 

6 

6 

066 

42 

7 

7 

07 

7 

7 

067 

43 

8 

8 

10 

8 

8 

070 

44 

9 

9 

11 

9 

9 

071 

45 

+ 

12 

60 

+ 

12-8-6 

053 

46 

47 

• 

11 

11-8-4 

40 

54 

* 

11 

11-8-4 

055 

052 

50 


0 1 

21 

/ 

0-1 

057 

51 

( 

0-8-4 

34 


12-8-5 

050 

52 


12 8 4 

74 

) 

11 8-5 

051 

53 

S 

11-83 

53 

S 

11-8-3 

044 

54 

= 

83 

13 

= 

8-6 

075 

55 

blank 

no punch 

20 

blank 

no punch 

040 

56 

, (comma) 

0-8-3 

33 

, (comma) 

0-8-3 

054 

57 

. (period) 

12-8-3 

73 

. (period) 

12-8-3 

056 

60 

= 

0-86 

36 

# 

8-3 

043 

61 


87 

17 

C 

12 8 2 

133 

62 

1 

0-8 2 

32 

3 

11-8-2 

135 

63 

% 

8 6 

16 

% ft 

0-8-4 

045 

64 

X 

8-4 

14 

" (quote) 

8 7 

042 

65 

i— 

085 

35 

(underline) 

0-8-5 

137 

66 

V 

11-0 

52 

! 

12-8 7 

041 

67 

A 

0-8-7 

37 

& 

12 

046 

70 


11-8-5 

55 

' (apostrophe) 

8-5 

047 

71 


11-8-6 

56 

? 

0-8 7 

077 

72 

< 

12-0 

72 


12-8-4 

074 

73 

> 

11-8-7 

57 

> 

0-8-6 

076 

74 

< 

8 5 

15 

@ 

8-4 

100 

75 

> 

12-8-5 

75 

\ 

0-82 

134 

76 


12-8-6 

76 

- (circumflex) 

11-8-7 

136 

77 

; (semicolon) 

12 -8 7 

77 

; (semicolon) 

11-8-6 

073 


^Twelve 2 ero bits at the end of a 60-bit word in a zero byte record are an end of record mark rather than 
two colons. 

*'ln installations using a 63-graphic set, display code 00 has no associated graphic or card code; display 
code 63 is the colon (8-2 punch). The % graphic and related card codes do not exist and translations 
yield a blank (55g). 
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TABLE A-3. EXTENDED BINARY CODED DECIMAL INTERCHANGE CODE (EBCDIC) 
WITH PUNCHED CARD CODES AND ASCII TRANSLATION 


■ 


B 
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8 
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IK 

©D 
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FF 
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■ 

■ 

2 

4 

2 
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72 
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7 
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7 

7 


u« 

7 

5 






■ 



7 

5 

BB 

4 

2 

2 

Bfl 


* 


7 

to Old 

h3h 

= 2 = 

> 2 > 
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H 

> 2 , 
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7 

T 

SB 

t 

? 

7 

■| 

■ 

a 

< 

o 

8 

o 

m 

ik 

8 


s 
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J,« 

7a 

T 8 

72 

7ff 

72 


HI 











7 

7 

7 

2 

7 


Ea 











4 

7 

7 

7 

4 

7 


■ 

7 


7 

ro 

7 

7 

7 

K 

7 

7 








■ 



x-x 

-j £ j 

S-S 

z-z 

0-0 


o-a 

c-t 



PE 

IS 

PE 

IS 

■■ 


a 

N 


IS 

* 

10 

♦ 

2 

© 

* 

? 

fN. 

? 

? 

IS CO 

78 
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f 
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? 
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IW 
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l UJ 

? 

f 
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3 
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E 6 
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67 

H 


S 

2 


i 

IS 

t 

IS 

1 

IS 

1 

is 

i 

IS 

i 

is 

i 

is 

1 

is 

A 

1 

17 


» 

IS 
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IS 

i 
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78 
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3 
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■ 

4 

A 


i 

IS 
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IS 

1 

IS 

7 

IS 

i 
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IS 

T 
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7 
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7 
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Q 
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TABLE A-2. AMERICAN NATIONAL STANDARD CODE FOR INFORMATION INTERCHANGE (ASCII) 
WITH PUNCHED CARD CODES AND EBCDIC TRANSLATION 
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EBCDIC Character-> 5A-*-EBCDIC Code (Hexadecimal! 










































































































































TABLE A-4. CONTROL DATA CHARACTER SETS 
SHOWING TRANSLATIONS BETWEEN DISPLAY CODE AND ASCII/EBCDIC 


Display 

Code 

ASCII 

EBCDIC 

Display 

Code 

ASCII 

EBCDIC 

Upper¬ 

case 

Lower¬ 

case 

Upper¬ 

case 

Lower¬ 

case 

Upper¬ 

case 

Lower¬ 

case 

Upper¬ 

case 

Lower¬ 

case 

Octal 

Char. 

Char. 

Hex 

Char. 

Hex 

Char. 

Hex 

Char. 

Hex 

Octal 

Char. 


Hex 

Char. 


Char. 

|Q| 

Char. 

Hex 

00 

: 


3A 

SUB 

1A 


7A 

SUB 

3F 

40 

5 


5 

35 

NAK 

15 

5 

F5 

NAK 

3D 

01 

A 

A 

41 

a 

61 

A 

Cl 

a 

81 

41 

6 


6 

36 

SYN 

16 

6 

F6 

SYN 

32 

02 

B 

B 

42 

b 

62 

B 

C2 

b 

82 

42 

7 


7 

37 

ETB 

17 

7 

F7 

ETB 

26 

03 

C 

C 

43 

c 

63 

C 

C3 

c 

83 

43 

8 


8 

38 

CAN 

18 

6 

F8 

CAN 

18 

04 

D 

D 

44 

d 

64 

D 

C4 

d 

84 

44 

9 


9 

39 

EM 

19 

9 

F9 

EM 

19 

05 



45 

e 

65 

E 

C5 

e 

65 

45 

D 

■ 

B 

2B 

VT 

08 

B 

4E 

VT 

0B 

06 



46 

f 

66 


C6 

f 

86 

46 

B 

1 

B 

2D 

CR 

0D 

■ 

60 

CR 

0D 

07 



47 

9 

67 


C7 

9 

87 

47 

D 

1 

B 

2A 

LF 

0A 

■ 

5C 

LF 

25 

10 

H 

H 

48 

h 

68 

H 

C8 

h 

88 

50 



/ 

2F 

SI 

OF 

/ 

61 

SI 

OF 

11 

B 

1 

49 

i 

69 

n 

C9 

i 

89 

51 

D 

■ 

< 

28 

BS 

08 

( 

4D 

BS 

16 

12 

H 
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4A 

i 

6A 

n 

D1 

i 

91 

52 

fl 

1 

i 

29 

HT 

09 

) 

5D 

HT 

05 

13 

B 

K 

4B 

k 

6B 

K 

D2 

k 

92 

53 

$ 


$ 

24 

EOT 

04 

$ 

5B 

EOT 

37 

14 

B 

L 

4C 

1 

6C 

L 

D3 

1 

93 

54 

= 


■ 

3D 

GS 

ID 


7E 

IGS 

ID 

15 

M 

M 

4D 

m 

6D 

M 

D4 

m 

94 

55 

SP 


E 

20 

NUL 

00 


40 

NUL 

00 

16 

N 

N 

4E 

n 

6E 

N 

D5 

n 

95 

56 



B 

2C 

FF 

oc 


6B 

FF 

0C 

17 

O 

O 

4F 

0 

6F 

O 

D6 

0 

96 

57 



B 

2E 

SO 

0E 


4B 

SO 

0E 

20 


P 

50 

P 

70 


D7 

p 

97 

60 

= 

# 

H 

23 

ETX 

03 

# 

7B 

ETX 

03 

21 


0 

51 

q 

71 


D8 

q 

98 

61 

! 


B 

5B 

FS 

1C 


4A 

1 FS 

1C 

22 


R 

52 

r 

72 


D9 

r 

99 

62 



B 

5D 

SOH 

01 

! 

5A 

SOH 

01 

23 


S 

53 

s 

73 


E2 

s 

A2 

63 

% 


% 

25 

ENQ 

05 

% 

6C 

ENQ 

2D 

24 

T 

T 

54 

t 

74 


E3 

t 

A3 

64 

* 

- 


22 

STX 

02 


7F 

STX 

02 

25 

U 

U 

55 

u 

75 

u 

E4 

u 

A4 

65 

- 

_ 

_ 

5F 

DEL 

7F 

_ 

6D 

DEL 

07 

26 

V 

V 

56 

V 

76 

V 

E5 

V 

A5 

66 

V 

i 

! 

21 

J 

7D 

1 

4F 

1 

DO 

27 

w 

w 

57 

w 

77 

w 

E6 

w 

A6 

67 

A 

& 

& 

26 

ACK 

06 

& 

50 

ACK 

2E 

30 

X 

X 

58 

X 

78 

■a 

E7 

x 

A7 

70 

T 


• 

27 

BEL 

07 


7D 

BEL 

2F 

31 

Y 

Y 

59 

V 

79 

B 

E8 

V 

A8 

71 

l 

? 

7 

3F 

us 

IF 

7 

6F 

IUS 

IF 

32 

z 

z 

5A 

z 

7A 

z 

E9 

Z 

A9 

72 

< 


< 

3C 

1 

7B 

< 

4C 

i 

CO 

33 

0 

0 

30 

DLE 

10 

0 

F0 

DLE 

10 

73 

> 


> 

3E 

RS 

IE 

> 

6E 

IRS 

IE 

34 

1 

1 

31 

DC1 

11 

1 

FI 

DC1 

11 

74 

< 

@ 

@ 

40 


60 

□ 

7C 


79 

35 

2 

2 

32 

DC2 

12 

2 

F2 

DC2 

12 

75 

> 

\ 

\ 

5C 

1 

l 

7C 

■ 

E0 

1 

1 

6A 

36 

3 

3 

33 

DC3 

13 

3 

F3 

TM 

13 

76 


A 

A 

5E 

- 

7E 

B 

5F 

~ 

A1 

37 

4 

4 

34 

DC4 

14 

4 

F4 

DC4 

3C 

77 

; 



3B 

ESC 

18 

B 

5E 

ESC 

27 


NOTES: 

1. The terms uppercase and lowercase apply only to the 
case conversions, and do not necessarily reflect any true 
case. 

2. When translating from Display Code to ASCII/EBCDIC, 
the uppercase equivalent character is taken. 

3. When translating from ASCII/EBCDIC to Display Code, 
the uppercase and lowercase characters fold together to 
a single Display Code equivalent character. 


4. All ASCII and EBCDIC codes not listed are translated to 
Display Code 55g(SP). 

5. Where two Display Code graphics are shown for a single octal 
code, the leftmost graphic corresponds to the CDC 64-character 
set, and the rightmost graphic corresponds to the CDC 64- 
character ASCII subset. 

6. In a 63-character set system, the display code for the : graphic 
is 63. The % character does not exist, and translations from 
ASCII/EBCDIC % or ENQ yield blank (55g). 
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DIAGNOSTICS 


B 


Diagnostic messages can either appear in the dayfile or are 
intermixed with Update output in the output file. In 
addition to detecting errors, Update detects overlapping 
corrections when the EXTOVLP installation option has been 
assembled. 


DIAGNOSTIC MESSAGES 

All diagnostic messages that can be issued during an 
Update run are listed in alphabetic order in table 8-1. One 
of the following codes is included for each diagnostic; 

Type Meaning 

I An informative message; processing 

continues. 

N A nonfatal error; processing continues. 

F A fatal error; processing is terminated. 


OVERLAPPING CORRECTIONS 

Update can detect four overlapping correction situations. 
When any of these types are detected, Update prints the 
line in error with the words TP.n OVLP appended on the far 
right of this line. Type n is one of the followings 


Type Meaning 

1 Two or more modifications are made to one 

card by a single correction set. 

2 A modification attempts to activate an 

already active card, 

3 A modification attempts to deactivate an 

already inactive card. 

4 A card is inserted after a card which is 
inactive on the old program library and is 
inactive on the new program library. 

The listing of overlap lines is controlled by list option 3. 

Detection of an overlap does not necessarily indicate a user 
error. Overlap messages are advisory, and they point to 
conditions in which the probability of error is greater than 
normal. If any overlap condition is encountered, a dayfile 
message is printed. 

Type TP.2 and TP.3 are detected by comparing existing 
correction history bytes with those to be added. Complex 
operations involving YANK and PURGE might generate 
these overlap messages even though no overlap occurs. 


TABLE B-l. DIAGNOSTICS 


Message 

Type 

Significance 

Action 

A OPTION INVALID WITH RANDOM 
OLDPL OR SEQUENTIAL NEWPL 

F 

The old program library is 
not sequential or the new 
program library is not ran¬ 
dom or is not on a random 
device for a sequential- 
to-random copy. 

Correct the error. 

***ADDFILE CARD INVALID ON 

REMOTE FILE*** 

F 

The ADDFILE directive cannot 
be used in the file specified 
by a READ directive. 

Remove the ADDFILE directive 
from the file specified by the 
READ directive. 

***ADDFILE FIRST CARD MUST BE 
DECK OR COMDECK*** 

F 

The first card (line) on the 
file specified by the ADDFILE 
directive is not a DECK or 
COMDECK directive. 

Correct the error. 
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TABLE B-l. DIAGNOSTICS (Contd) 


Message 

Type 

Significance 

Action 

***ALL YANK, SELYANK, YAWCDECK, 
AND CALL CARDS AFFECTED HAVE 

BEEN CHANGED*** 

I 

If Update changes any identi¬ 
fiers during a merge, it also 
changes the corresponding 

YANK, SELYANK, YANKDECK, and 

CALL directives. 

None. 

B OPTION INVALID WITH SEQUENTIAL 
OLDPL 

E 

The old program library is not 
random for a random-to- 
sequential copy. 

Do not specify B on the control 
statement. 

***BAD ORDER ON YANK 

DIRECTIVE*** 

N 

Identifiers separated by a 
period on the YANK directive 
are in the wrong order. 

Correct the order of the 
identifiers. 

***CARD NUMBER ZERO OR INVALID 
CHARACTER IN NUMERIC FIELD*** 

F 

Sequence number field on the 
correction directive is 
erroneous. 

Correct the sequence number. 

***CONTROL CARD INVALID OR 

MISSING 

F 

Update detected a format error 
on a directive, deleted a 
directive that was unrecogniz¬ 
able, or detected an illegal 
file name. Illegal operations 
such as INSERT prior to an 

IDENT could also have been 
attempted. 

Correct the error. 

***COPY TO EXTERNAL FILE NOT 
ALLOWED WHEN READING ALTERNATE 
INPUT UNIT*** 

N 

No copy is made. 

Correct the error. 

COPYING INPUT TO TEMPORARY 

NEWPL 

I 

A sequential new program 
library was requested on a 
creation run. 

None. 

COPYING OLDPL TO A RANDOM FILE 

I 

The old program library is 
being copied to a random file. 

None. 

CREATING NEW PROGRAM LIBRARY 

I 

Indicates that a new program 
library is being created. 

None. 

***DECK NAME ON ABOVE CARD NOT 
LAST DECLARED DECK*** 

I 

When a DECLARE directive is in 
effect, only card images 
belonging to decks specified 
can be modified or referenced. 

Add appropriate DECLARE direc¬ 
tives or remove directives 
which reference non-declared 
decks. 

***DECK SPECIFIED ON MOVE OR 

COPY CARD NOT ON OLDPL, CARD 

WILL BE IGNORED*** 

I 

The specified deck will not be 
moved or copied. 

Correct the error. 

DECK STRUCTURE CHANGED 

I 

A deck has been moved or 
deleted. 

None. 

***DO/DONT IDENT idname IS NOT 
YANKED/YANKED NULL DO/DONT*** 

I 

A DO directive, to negate the 
effect of a YANK, references 
an identifier that has been 
yanked; or a DONT directive, 
to restore a YAW, references 
an identifier that was already 
yanked. 

None. 
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TABLE B-l. DIAGNOSTICS (Contd) 


Message 

Type 

Significance 

Action 

♦♦♦DUPLICATE OECK dname NEWPL 
ILLEGAL*** 

F/N 

Update encountered an active 

DECK of COMDECK directives 
that duplicates a previous 
directive. This condition is 
fatal if a new program library 
is being created; nonfatal if 
a new program library is not 
being created. 

Change one of the deck names. 

***DUPLICATE FILE NAME OF file, 
JOB ABORTED*** 

F 

Same file name has been 
assigned to two Update files. 

Change one of the file names. 

♦♦♦DUPLICATE IDENT CHANGED TO 
ident*** 

N 

Update changed a duplicate 
identifier name to a unique 
one. 

None. 

♦♦♦DUPLICATE IDENT NAME*** 

F 

During a merge run, Update 
encountered a duplicate 
identifier name that it could 
not make unique. 

Change one of the identifiers. 

♦♦♦DUPLICATE IDENT NAME IN 
ADOFILE*** 

F 

The name of a correction set 
to be added as a result of an 
ADDFILE directive duplicates 
a correction set name on the 
old program library. 

Change the name of the 
correction set. 

DUPLICATE SECONDARY OLDPL 

IGNORED 

I 

Two secondary old program 
libraries have the same name. 

Correct the error or ignore. 

♦♦♦ERROR. NO PERMISSION TO 

WRITE NEWPL*** 

F 

Both MODIFY and EXTEND 
permission must be present 
to overwrite a permanent 
(direct access) file. 

Attach file with correct 
permissions. 

***ERROR***NOT ALL MODS WERE 
PROCESSED*** 

F 

All changes indicated in the 
input stream were not pro¬ 
cessed. 

Make sure that names specified 
on correction directives corre¬ 
spond to identifiers on the old 
program library (or on the 
COMPILE directive if in quick 
mode). 

♦♦♦ERROR. WIDTH EXCEEDS 256 
CHARACTERS*** 

N 

Total of statement width plus 
ident field width is greater 
than 256 characters on *WIDTH 
statement. 

Correct *WIDTH statement. 

♦♦♦FILENAME OF file IS TOO LONG, 
UPDATE ABORTED*** 

F 

A file name exceeds seven 
characters. 

Correct the file name. 

♦♦♦FILENAME ON ABOVE CARD 

GREATER THAN SEVEN 

CHARACTERS*** 

F 

A file name exceeds seven 
characters. 

Correct the file name. 

FILE NAME ON UPDATE CARD GR 

7 CHARACTERS 

F 

A file name on the UPDATE 
control statement is greater 
than seven characters. 

Correct the error. 

G AND 0 FILES CANNOT HAVE SAME 
FILENAME 

F 

The G and 0 control statement 
options specify the same file 
name. 

Change one of the names. 
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TABLE B-l. DIAGNOSTICS (Contd) 


Message 

Type 

Significance 

Action 

GARBAGE IN OLDPL HEADER, 

UPDATE ABORTED 

F 

Invalid data was found in the 
random index. 

Rerun job/re-create program 
library. If the problem still 
exists, follow site-defined 
procedures for reporting soft¬ 
ware errors or operational 
problems. 

***IDENT CARD MISSING, NO NEWPL 
REQUESTED, DEFAULT IDENTIFIER OF 
.NO.ID. USED*** 

I/F 

If no new program library is 
generated, then a correction 
set need not be introduced by 
an IDENT directive. The iden¬ 
tifier .NO.ID. is used. 

Add IDENT directive if new 
program library is to be 
generated. 

IDENT xxxxx WILL NOT BE 

PROCESSED 

I 

Named correction set not 
processed because dependency 
condition (K or U parameter on 
the IDENT directive) has not 
been met. 

None. 

***IDENT LONGER THAN NINE 
CHARACTERS*** 

F 

An identifier can only have up 
to nine characters. 

Correct the identifier. 

♦♦♦IDENTIFIERS SEPARATED BY 

PERIOD IN WRONG ORDER*** 

F 

The specified identifiers are 
not in the correct order. 

Switch the identifiers. 

♦♦♦ILLEGAL CONTROL CARD IN 
ADDFILE*** 

F 

ADDFILE insertions cannot con¬ 
tain correction directives. 

Remove the correction 
directives. 

IMPROPER MASTER CHARACTER 

CHANGED TO char 

N 

The character specified on the 
* control statement parameter 
is not the same as the master 
control character on the old 
program library. 

Use the same master control 
character as on the old program 
library. 

INSUFFICIENT FIELD LENGTH, 

UPDATE ABORT 

F 

The table manager ran out of 
room for internal tables. 

Allocate more field length. 

***IT MAY EXIST IN A DECK NOT 
MENTIONED ON A COMPILE CARD*** 

F 

An identifier references a 
card (line) in a deck not spe¬ 
cified on a COMPILE directive 
(only if in quick mode). 

Correct the error. 

♦♦♦INVALID NUMERIC FIELD*** 

F 

The directive does not contain 
required numeric field. 

Correct the directive. 

♦♦♦LENGTH ERROR ON OLDPL. 

UNUSABLE OLDPL OR HARDWARE 
ERROR*** 

F 

Line length on old program 
library is greater than the 
maximum allowed or is less 
than one. 

Rerun job. If problem still 
exists, then re-create the pro¬ 
gram library. 

♦♦♦LISTED BELOW ARE ALL IDENT 
NAMES WHICH WERE CHANGED 

DURING THE MERGE*** 

I 

Update changes any duplicate 
identifiers to make them 
unique when merging two pro¬ 
gram libraries. 

None. 

***NEW IDENT ON CHANGE CARD IS 
ALREADY KNOWN*** 

F 

An attempt was made to change 
a correction set identifier to 
one already in existence. 

Correct the error. 

***N0 ACTIVE CARDS WERE FOUND 
WITHIN THE COPY RANGE. NULL 
COPY*** 

N 

All card images within the 
specified range are inactive. 

None. 

***N0 DECK NAME ON DECK CARD*** 

F 

No name was specified on the 

DECK directive. 

Specify a name. 


B-4 


60449900 C 







TABLE B-l. DIAGNOSTICS (Contd) 


Message 

Type 

Significance 

Action 

NO INPUT FILE, Q MODE, UPDATE 

ABORT 

F 

In quick mode. Update relies 
on the input file to determine 
what is written to the compile 
file. 

Put appropriate COMPILE 
directives in the input file. 

NO OLDPL, NOT CREATION RUN, 

UPDATE ABORT 

F 

No old program library was 
supplied on a non-creation 
run. 

Correct the error. 

***NULL ADDFILE*** 

I 

The first read on the file 
specified by ADDFILE encounter¬ 
ed an end-of-record. If the 
input file was specified, the 
first read encountered an 
illegal directive. 

Correct the error. 

***NULL IDENT*** 

F 

An identifier was not found on 
a directive where one was 
expected. 

Correct the directive. 

***NULL DECK NAME*** 

F 

During ADDFILE or a CREATION 
run. Update encountered a DECK 
or COMDECK directive that did 
not have a name. 

Correct the directive. 

***OLDPL READ ERROR - ATTEMPTING 
RECOVERY*** 

***READ RECOVERED - DATA LOST 
BEFORE THE FOLLOWING CARD*** 
card Image 

F 

A parity error or other error 
has occurred while processing 
an old program library. As a 
result, Update Is uncertain of 
the position of the old pro¬ 
gram library. The line image 
printed is the next valid line 
that Update was able to find 
following the error. 

Rerun the job. If the U option 

Is used, card images might be 
lost on the NEWPL. 

OLDPLS HAVE DIFFERENT 

CHARACTERS SETS 

I 

The merging of two old program 
libraries with different char¬ 
acter sets Is not allowed. 

Use program libraries with the 
same character set. 

***OUTPUT LINE LIMIT EXCEEDED. 

LIST OPTIONS 3 AND 4 DEFEATED*** 

N 

Update output exceeds the 
line limit specified by 
default or by the LIMIT 
directive. 

Use the LIMIT directive to 
increase one unit. 

PLS HAVE DIFFERENT CONTROL 
CHARACTERS, ABORT 

F 

The merging of two program 
libraries with different 
control characters is not 
allowed. 

Use program libraries with the 
same control characters. 

♦♦♦PREMATURE END OF RECORD ON 

OLD PROGRAM LIBRARY*** 

F 

A PRU of level 0 was 
encountered in the line image. 

Rerun the job. If error still 
exists, re-create the program 
library. 

READING INPUT 

I 

The input file is being read 
by Update. 

None. 

♦♦♦RECURSIVE CALL ON COMDECK 
dname IGNORED. FATAL ERROR*** 

F 

A common deck has called 
itself or common decks that 
contain calls to the specified 
common deck. 

Correct the error. 

SECONDARY OLDPL NOT RANDOM 

F 

Secondary old program 
libraries must be random. 

Use random secondary old 
program libraries. 

♦♦♦SEQUENCE NUM8ER EXCEEDS 
131071*** 

F 

The proper range of sequence 
numbers is 1 through 131071. 

Correct the error. 
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TABLE B-l. DIAGNOSTICS (Contd) 


Message 

Type 

Significance 

Action 

STACK DEPTH EXCEEDED 

F 

Stack in which line images are 
placed became full while 
processing a BEFORE or ADDFILE 
directive. 

Follow site-defined proced¬ 
ures for reporting software 
errors or operational prob¬ 
lems. (Increase RECURDEP). 

TABLE MANAGER LOGIC ERROR 

F 

There is not enough table 
space to accommodate the old 
program library tables. 

Increase field length. 

***THE ABOVE CALLED COWON 

DECK WAS NOT FOUND*** 

F 

The called common deck could 
not be found. 

Check the spelling of the deck 
name. If creating a program 
library with calls to secondary 
old program libraries, set C a 0 
on the UPDATE control 
statements. 

***THE A80VE CARD IS ILLEGAL 

OURING A CREATION RUN*** 

F 

A directive that is not 
allowed on a creation run was 
encountered. 

Remove the illegal directive. 

***THE ABOVE CARD IS ILLEGAL 

IN AN ALTERNATE FILE. IGNORED*** 

N 

Directives *READ, *$KIP, or 
♦REWIND are illegal in an 
alternate file. 

Remove the illegal directives. 

***THE ABOVE CONTROL CARD IS 
ILLEGAL AFTER A DECK HAS BEEN 
DECLARED*** 

N 

CHANGE, PURGE, and YANK 
directives are illegal after a 
deck has been specified on a 
DECLARE directive. They are 
ignored. 

Remove the illegal directives. 

***THE ABOVE LISTED CAROS 

CANNOT EXIST IN THE YANK DECK 

AND HAVE BEEN PURGED DURING 
EDITING*** 

I 

Only YANK, YANKDECK, SEL- 
YANK, and DEFINE directives 
are kept in the YANKSSS deck. 

None. 

***THE ABOVE OPERATION IS NOT 

LEGAL WHEN REFERENCING THE 

YANK DECK*** 

F 

The specified operation is 
illegal when referencing the 
YANK$$$ deck. 

Correct the error. 

***THE ABOVE SPECIFIED CARD 

WAS NOT ENCOUNTERED*** 

F 

Update could not locate the 
specified card on the old pro¬ 
gram library. 

Make sure that the correct 
Identifier is specified. 

***THE INITIAL CARD OF THE COPY 
RANGE WAS NOT FOUND. NULL 

COPY*** 

N 

No copy was made. 

Make sure that the correct 
identifier is specified. 

***THE TERMINAL CARD OF THE 

COPY RANGE WAS NOT FOUND. 

COPY ENDS AT END OF SPECIFIED 
DECK*** 

I 

The terminal card (line) spe¬ 
cified was not found; the rest 
of the deck was copied. 

Make sure that the correct 
identifier is specified. 

***THE TERMINAL CARD SPECIFIED 

WAS NOT ENCOUNTERED*** 

F 

While processing a card (line) 
range. Update could not locate 
the last card (line) of the 
range. 

Make sure that the correct 
identifier is specified. 

THIS UPDATE REQUIRED n WORDS OF 
CORE 

I 

It took n words of memory for 
the update. 

None. 

***T00 MANY CHBS — INCREASE 
L.CHB*** 

F 

Correction history bytes 
exceed the specified limit of 
IOOq for a line. 

Follow site-defined proced¬ 
ures for reporting software 
errors or operational pro¬ 
cedures. 
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TABLE B-l. DIAGNOSTICS (Contd) 


Message 

Type 

Significance 

Action 

TOO MANY SECONDARY OLDPLS 

SPECIFIED 

F 

Up to seven secondary old 
program libraries can be 
specified. 

Specify seven or fewer 
secondary old program 
libraries. 

♦♦♦UNBALANCED TEXT/ENDTEXT 

CARDS, LAST ENDTEXT CARD 

IGNORED*** 

N 

Update encountered more 

ENDTEXT directives than TEXT 
directives. 

None. 

♦♦♦UNKNOWN IDENTIFIER idname*** 

F 

A correction directive 
references an identifier not 
found in the directory. 

Make sure that the correct 
identifier is specified. 

UPDATE COMPLETE 

I 

The update is completed. 

None. 

UPDATE CONTROL CARD ERROR(S) 

F 

The UPDATE control statement 
contains unacceptable 
parameters. The erroneous 
parameters are listed on the 
next line. 

Correct the erroneous 
parameters. 

UPDATE CREATION RUN 

I 

This Update run was a creation 
run. 

None. 

WAITING FOR 45000B WORDS 

I 

Update is waiting for the 
operating system to allocate 
enough memory. 

None. 

***OLDPL CHECKSUM 

ERROR*** 

F 

At least one updated deck 
from the old program library 
is bad. 

Rerun Job. If problem still 
exists, follow site-defined 
procedures for reporting soft¬ 
ware errors or operational 
problems. 

♦♦♦YANK, SELYANK, OR YANKDECK 
ident NOT KNOWN*** 

N 

The identifier referenced on a 
YANK, SELYANK, or YANKDECK has 
probably been purged; this 
applies to lines already on 
the library. 

Remove the yank directive 
from the YANK$$$ deck. 

♦♦♦deckname IS NOT A VALID DECK 
NAME*** 

F 

A deck name has 1 through 9 
characters; legal characters 
are: A through Z, 0 through 

9, and + - * /() $=. 

Correct the deck name. 

***n ERRORS IN INPUT*** 

I 

Update encountered n fatal 
errors in the input stream. 
Processing continues in order 
to detect addtional errors. 

This message is issued only if 
the U parameter is specified 
on the control statement. 

None. 

***n ERRORS IN INPUT, NEWPL, 
COMPILE, SOURCE SUPPRESSED*** 

I 

Update encountered n fatal 
errors in the input stream. 
Processing continues in order 
to detect errors. A new 
program library, a compile 
file, and a source file are 
not generated. 

None. 

n ERRORS IN UPDATE INPUT 

I 

First pass of Update pro¬ 
cessing encountered n fatal 
errors while reading a 
correction set. 

None. 
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TABLE B-l. DIAGNOSTICS (Contd) 


Message 

Type 

Significance 

Action 

n DECLARE ERRORS 

I 

Indicates the number of 
directives that reference 
line images in decks not 
specified on DECLARE 
directives. 

None. 

n FATAL ERRORS 

I 

Indicates the number of errors 
which caused Update to abort. 

None. 

n NONFATAL ERRORS 

I 

Indicates the number of errors 
which did not cause Update to 
abort. 

None. 

n OVERLAPPING CORRECTIONS 

I 

A correction set changed the 
status of some lines more than 
once or referenced an inactive 
line image. 

None. 

n UPDATE ERRORS, JOB ABORTED 

_i 

Errors were encountered in 
reading the input file. 

None. 
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I ASCII - 

American Standard Code for Information Interchange. 
ASCII input and output codes for Update are 8-bit 
characters right-justified in a 12-bit byte. 

Common Deck - 

A deck that is written on a compile file as a result of a 
CALL directive. The COMDECK directive introduces 
a common deck. 

Compile File - 

The file generated by Update that contains card 
images restored to a format that is acceptable to a 
compiler or assembler. 

Copy Run - 

An Update run that performs a sequential-to-random 
or random-to-sequential copy of a program library. 
Contrast with creation run and correction run. 

Correction History Byte - 

A byte added to a card image by Update each time the 
status of the card image changes. The correction 
history byte tells Update whether or not a card image 
is active or inactive and which correction set modified 
the card image. 

Correction Run - 

An Update run in which changes can be made to a 
program library. Contrast with copy run and creation 
run. 

Correction Set - 

A set of directives and text that direct Update to 
modify a program library. The IDENT directive 
introduces a correction set. 

Creation Run - 

An Update run that constructs a program library. It is 
the original transfer of cards into Update format. 
Contrast with copy run and correction run. 

Deck - 

A deck consists of a DECK or COMDECK directive 
and all text and directives until the next DECK or 
COMDECK directive. It is the smallest unit that can 
be extracted from a program library. 

Deck List - 

A list internal to Update that contains the names of all 
decks in the program library and the location of the 
first word for each deck. 

Directory - 

A list that contains one entry for each DECK, 
COMDECK, and IDENT directive that is used for the 
program library. 

Full Update Mode - 

An Update run in which the F parameter is selected on 
the control statement causing Update to process all 
decks on the library. Contrast with normal selective 
mode and quick Update mode. 


Identifier - 

The name of a deck, common deck, or correction set. 
Input File - 

The user-supplied file or part of the job deck that 
contains the input stream of Update directives and 
text. 

Known - 

A deck name or identifier is on the primary old 
program library. The deck name must be in the deck 
list on the primary old program library and an 
identifier must be In the directory on the primary old 
program library. 

Line Identifier - 

The combination of identifer and sequence number 
that uniquely identifies each card image in a program 
library. 

Master Control Character - 

A character in column 1 that informs Update that the 
card contains a directive. 

Merge File - 

The file that contains a program library to be merged 
with the old program library into a new program 
library. 

New Program Library - 

The program library initially generated on a creation 
run. A new program library that incorporates the 
changes made during a correction run is generated if 
requested. 

Normal Selective Mode - 

An Update run in which the F and Q options are not 
selected on the control statement. All decks specified 
on COMPILE directives as well as all corrected decks 
are processed. Contrast with full Update mode and 
quick Update mode. 

Old Program Library - 

The program library to be modified. 

Output File - 

The listing file generated by Update that contains the 
status information produced during Update execution. 
It is in a form suitable for printing. 

Program Library - 

The file generated by an Update run that contains the 
decks of card images.. Card images in the program 
library are in a format that can be manipulated by 
Update, but that is meaningless for all other purposes. 

Pullmod File - 

A file that contains directives and text or re-created 
correction sets specified on PULLMOD directives. 
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Quick Update Mode - 

An Update run in which the Q option is selected on the 
control statement. Only decks specified on COMPILE 
directives and called common decks are processed. 
Contrast with full Update mode and normal selective 
mode. 

Secondary Old Program Library - 

A program library from which decks on the old 
program library can call common decks. 

Sequence Number - 

A number supplied by Update that uniquely identifies a 
card image. 

Source File - 

The file generated by update that contains card images 
of an input stream that would allow regeneration of 
the program library. 

System-Logical Record - 

Under NOS/BE, a data grouping that consists of one or 
more PRUs terminated by a short PRU or zero-length 
PRU. These records can be transferred between 
devices without loss of structure. Equivalent to a 
logical record under NOS. 


Table C-l shows equivalency under SCOPE 2. 


TABLE C-l. RECORD TYPE UNDER SCOPE 2 


Type 

Level 

Equivalency 

RT=W 

0 thru 160 

end-of-section 

RT=W 

1*8 

end-of-partition 

RT=S 

0 thru 170 

end-of-record 

RT=Z 

0 thru 170 

end-of-section 

BT=C 

0 thru 170 

end-of-section 


Unknown - 

A deck name or identifier that is not on the old 
program library. A deck name or identifier can be 
made unknown by being purged. 
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FILE FORMAT AND STRUCTURE 


D 


The files generated and used by Update have formats 
determined by both the operating system in use and the 
user. This appendix describes default file formats, allowed 
file formats, and the interchangeability of files among 
operating systems. Table D-l summarizes file structure 
according to the operating system used. 

LIBRARY FILE FORMATS 

Update can create and maintain library files in two 
distinctly different formats: random and sequential. These 
formats are described in detail below. Random format 
should be used whenever possible because it can be 
processed substantially faster than sequential format. 

RANDOM FORMAT 

On a random format library, each deck is a system-logical 
record as shown in figure D-l. The deck records are 
followed by records containing the deck list, the directory, 
and the random index. 



Random Index 

The random index tells Update the beginning point and 
length of the directory and the deck list. The index also 
contains such information as the master control character 
and the character set used when the library was generated. 
Random index format is shown in figure D-2. 

Two copies of the random index are generated under 
SCOPE 2 because Update generates another copy when it 
closes the file. The closing of the file is a process internal 
to Update. 

Under SCOPE 2, Update adds a 2-word header to the 
random index that indicates the number of words in the 
index. SCOPE 2 header format is shown in figure D-3. 


Copying to Tape 

Random program libraries should be copied to tape through 
Update parameters. To copy a random program library to 
tape under NOS or NOS/BE, use the UPDATE control 
statement: 

UPDATE(B,P=plname,N=lfn) 

where plname is the library name and lfn is the tape file. 
To copy the library back to mass storage, use: 

UPDATE(A,P=lfn,N=newpl) 

where lfn is the tape file and newpl is the new program 
library name. 

Under SCOPE 2, use the UPDATE control statement: 
UPDATE(F,P=plname,N=lfn) 

to copy a random program library to tape. The program 
library name is plname and lfn is the tape file. To copy the 
library back to mass storage, use: 

UPDATE(F,P=lfn,N=newpl) 

where lfn is the tape file and newpl is the new program 
library name. 


SEQUENTIAL FORMAT 

Update optionally creates new program libraries in 
sequential format. On magnetic tape, a sequential library 
(SI tape format or I tape format (NOS only)) is written as 
one record in binary (figure D-4). The first word in the file 
is a display code key word (figure D-5); the second is a 
counter word containing the number of deck names in the 
deck list and the count of correction set identifiers in the 
directory (figure D-6). The last ward in the file is a 
checksum (figure D-7). 


Figure D-1. Random Program Library Format 
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■1 

NOS/BE 

NOS 

SCOPE 2 

KM 

Tape 

Mass Storage 

Tape 

Mass Storage 

Tape 

Mass Storage 

P=0LDPL 

Binary 

SI tape 

i 

Random or 
sequential 

Binary 

SI tape or 

I tape 

j 

Random or 
sequential 

Binary, sequential^" 
RT=W or S 

Random: RT=W, 
unblocked 

Sequential: RT=W, 
unblocked 

RT=W 

N=NEWPL 

Binary 

SI tape 

Random or 

W - sequential 

Binary 

SI tape or 

I tape 

Random 

W - sequential 

Binary, sequential 
RT=W or S 

Random if unblocked 

Sequential if blocked 
or if W specified 
on Update control 
statement. 

RT=W,unblocked by 
default. 

RT=blocked W or S; 
specified through 
FILE control state¬ 
ment. 

Cannot be blocked if 
random. 

C=C0MPILE 

Binary 

Sequential 

RT=Z 

Binary 

Sequential 

RT=Z 

RT=W,I blocked. 

Other types deter¬ 
mined by FILE con¬ 
trol statement. 

RT=W,unblocked. 

RT=S if compressed 
file; S specified 
through FILE con¬ 
trol statement. 

1= INPUT 

1 

Binary 

Sequential 

RT=Z 

Binary 

Sequential 

RT*Z 

RT=W,I blocked. 

Other blocking or 
RT=Z,FL s100 
through FILE con¬ 
trol statement. 

RT=W,unblocked 

RT=W blocked or RT=Z, 
FL £ 100 through FILE 
control statement. 

0=OUTPUT 

Binary 

Sequential i 

RT=Z 

1 

Binary i 

Sequential 

RT=Z 

RT=W,I blocked. 

Other types possible 
through FILE control 
statement. 

RT=W,unblocked 

S=$0URCE 

Binary , 

Sequential ; 

RT=Z ! 

j 

Binary 

Sequential 

RT=Z 

RT=W,I blocked. 

Other blocking or 
RT*Z,FLs100 through 
FILE control state¬ 
ment. 

RT=W,unblocked 

RT=W blocked or RT=Z 
if specified 
through FILE con¬ 
trol statement. 

*READ Ifn or 
♦ADDFILE lfn 

Binary 

Sequential ! 

RT=Z 

Determined 
by REQUEST 
control 
statement 

Sequential 

RT=Z 

RT=W,I blocked. 

Other blocking or 
RT=Z,FL s100 through 
FILE control state¬ 
ment. 

RT=W,unblocked 

RT=W blocked or RT=Z 
if specified 
through FILE con¬ 
trol statement. 


^Random files can be put on tape by copying the file to tape. To access this file, it must first be copied 
to a W unblocked file. W records are 5120 characters in length. SCOPE 2 Update checks for presence of 
directory header containing DIRECTS to identify random file and for presence of CHECK in word 1 of sequen¬ 
tial file. If both tests fail, library format is unacceptable. Random format library must be unblocked W 
records. 


NOTE 

Update uses 7000 record manager for I/O, but Update does not use 6000 record manager (8AM) Basic Access 
Method. A FILE control statement can be used with SCOPE, but this control statement is ignored under NOS and 
NOS/BE. 
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7000 

dll 

dllra 

unused 

dirl 

dirra 

unused 

m 

X 

lab 

Y 

c 

label 

label (contd) 


7000 Identifies random directory record. 


dll 

dllra 

dirl 

dirra 

m 


x 


lab 


V 


c 


Length of the deck list in words. 

Random address of first word of deck list. 


Length of directory in words. 

Random address of first word of directory. 


Indicates presence of deck bits in deck list 

1 Deck bits present, 

other Deck bits not present. 

Character set identifier determined by IP.CSET parameter. 


3 (36o) 

4 <37 s ) 

7 <42g) 

8 (43g) 


IP.CSET is set for a 63-character set. 

IP.CSET is set for a 64-character set. 

IP.CSET is set for 63-character set plus ASCII. 
IP.CSET is set for 64-character set plus ASCII. 


Label flag: 

nonzero Words 3 and 4 contain tape label. 

0 Words 3 and 4 not present. 


SCOPE 2 does not recognize tape labels. 


Indicates which character set was used when the library was generated. 

Y or null 64-character set used, 
other 63-character set used. 


Indicates master control character in use when the library was created. 


Figure D-2. Random Index Format 


59 _1Z_0 


DIRECTS 

unused 

n 


n Number of words in the random index. 


Figure D-3. SCOPE 2 Random Index Header Format 
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DECK LIST 


Display Code Key Word 


Counter Word 


Directory 


Deck List 


YANK$$$ Deck 


Deck 1 


Deck 2 



YANK$$$ DECK 

The YANK$$$ deck is automatically created on a creation 
run as the first deck on the program library. It does not 
have a DECK card as its first card imaqe. On correction 
runs, Update inserts into the YANK$$$ deck any YANK, 
SELYANK, YANKDECK, and DEFINE directives that it 
encounters during the read-input-stream phase. These 
directives acquire identification and sequence information 
from the correction set from which they originate. On a 
merge, the two YANK$$$ decks are merged into a single 
deck. 

Although the YANK$$$ deck as a whole cannot be yanked 
or purged, cards in the deck can be deleted, yanked, or 
purged. If information other than the four directive types 
mentioned inadvertently gets into the YANK$$$ deck, this 
information can be purged through the E option on the 
Update control statement. The YANK$$$ deck is 
maintained in display code. 


The deck list is a table that contains an entry for each deck 
on the progrm library. Each entry on a sequential program 
library consists of one word containing the deck name; bit 
three is reserved for the deck bit that indicates whether or 
not the deck is a common deck. Each deck list entry on a 
random program library consists of two words as shown in 
figure D-8. The deck list is maintained in display code. 


DIRECTORY 

The directory is a table that contains one entry for each 
DECK, COMDECK, and IDENT that has ever been used for 
this library. Directory entries each consist of one word 
containing the 1 through 9 character identifier in display 
code, left-justified with zero fill. Correction set 
identifiers and deck names are listed chronologically as 
they are introduced into the library. The directory is 
maintained in display code. 

A deck name that has been purged remains in the table 
although it is not printed on the listable output file. The 
purged deck names are not removed from the table unless 
the E (edit) parameter is specified on the Update control 
statement. 

The number of identifiers in the directory is limited by the 
amount of central memory (or small core memory) 
available. 

Each directory entry has the format shown in figure D-9. 
For a purged identifier, bits 59 through 6 are zeros, and 
bits 5 through 0 contain a 20g. 


COMPRESSED TEXT FORMAT 

Text is an indefinite number of words that contain a 
correction history and the compressed image of each card 
in the deck. Information for each card is in the format 
shown in figure D-10. 

OLD SEQUENTIAL FORMAT 

Update accepts library files in the old (pre-SCOPE 3.4) 
Update sequential format as shown in figure D-ll. These 
libraries resemble the new sequential format but do not 
contain the CHECK word or checksum, and the text format 
and correction history bytes are different. Word 2 on the 
new format is the same as word 1 on the old format. 
Update no longer generates this obsolete sequential format. 


INTERCHANGEABILITY OF LIBRARIES 

When the random format libraries have been copied to 
tapes, the libraries have limited interchangeability among 
the operating systems. This interchangeability is shown in 
table D-2. 
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CHECK 


00 m x I lab 


CHECK Identifies the file as being a sequential file, 

m Indicates presence of deck bits in deck list: 

1 Deck bits present, 

other Deck bits not present. 

x Character set identifier determined by IP.CSET parameter: 

3 (36g) IP.CSET is set for a 63-character set. 

4 (37g) IP.CSET is set for a 64-character set. 

7 (42g) IP.CSET is set for 63-character set plus ASCII. 

8 {43g) IP.CSET is set for 64-character set plus ASCII. 


Label flag: 


Indicates labeled tape. 
Indicates unlabeled tape. 


SCOPE 2 does not recognize tape labels. 

Indicates which character set used when the library was generated: 

Y or null 64-character set used, 
other 63-character set used. 

Indicates master control character in use when the library was created. 


Figure D-5. Display Code Key Word Format 











59 

29 

5 

3 

0 

dname 

un 

d 

un 

unused 

ra 


dname 1 through 9 alphanumeric character deck name obtained from DECK or COMDECK directive when 
deck was placed on library. The first dname is YANK$$$. 

un Unused. 

d Deck bit. Indicates kind of deck. 

0 Common deck. 

1 Regular deck. 

ra Random address of first word of compressed text for the deck. 

Figure D-8. Random Program Library Deck List Format 


59 


5 0 


identifier 


unused 


Figure D-9. Directory Format 


TABLE D-2. FILE INTERCHANGEABILITY 


System That Generated 
Random Library on 

Tape 

System to Read 

Random Library From 
Tape+ 

NOS 

NOS/BE 

SCOPE 2 

NOS 1 

Yes 

No 

No 

NOS/BE 1 

Yes 

Yes 

No^ 

SCOPE 2 

No 

No 

Yes 


+A yes indicates the tape can be read; a no 
indicates it cannot. 


++ Must be copied to unblocked mass storage 
file when read in. 


Sequential program libraries are interchangeable among 
operating systems when they are system-logical records 
(Record Manager type S records). 

COMPILE FILE FORMAT 

Through control statement parameters, the user can 
SDecify whether the text on the compile file is to be 
compressed or expanded, and sequenced or unsequenced. 
The expanded compile file format for each card consists of 
72 or 80 columns of data followed by 0 to 18 columns of 
sequence information. The maximum size of a card image 
is 90 columns. 

Update attempts to place sequence information in the 
columns remaining in the card image after the data 
columns have been allocated. When the data field is 72 and 
the card image is 90 columns, column 73 is blank and 17 
columns are available for sequencing information. In this 
case, the 1 to 9 character identifier is left-justified in 
column 74, and the sequence number is right-justified in 
column 86. 
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c 


a 


stat 


a 


b 


d 


wc 

seqnuin 

chbj 



Correction history byte flag. Indicates the last word containing correction history bytes. 

0 Not last word. 

1 Last word. 


Activity bit for the card. 

0 Card is inactive. 
1 Card is active. 


Card status: 



Activity bit: 

0 Card is inactive. 

1 Card is active. 

Character set mode: 

0 Character set is display code. 

1 Character set is ASCII. 

Yank deck indicator ("DECK directive only): 


0 Deck not yanked. 

1 Deck yanked. 

Number of words of compressed text for this card, excluding words containing correction history bytes. 

Sequence number of card (octal) according to position in deck or correction set identified by chb 1. 

Correction history byte. Update creates a byte for each correction set that changes the status of the card. 
The format of chb is. 



0 Card not yanked. 

1 Card has been yanked. 

a Activity bit: 

0 Correction set deactivated the card. 

1 Correction set activated the card. 


Figure D-10. Compressed Text Format on Program Library (Sheet 1 of 2) 
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Compressed card 
in display code 


Compressed card 
in ASCII code 


identno Index to the entry in the directory that contains the name of the correction set or deck that 
introduced the card or changed the card status. 

The compressed image of the card in display code. Single and double spaces are unaltered. Three or more 
embedded spaces are replaced in the image as follows: 

3 spaces replaced by 0002g 

4 spaces replaced by 0003g 

5 spaces replaced by 0004g 


64 

65 

66 
67 


spaces 

spaces 

spaces 

spaces 


replaced by 0077g 
replaced by 007755g 
replaced by 00775555g 
replaced by 00770002g, etc. 


Trailing spaces are not considered as embedded and are not included in the card image. A 4-digit octal 
code 0000 or word count (wc) reached marks the end of the card. This is conditional on the CHAR64 
option. 


When the full-character set installation option is assembled, a byte of 0001 


represents a colon. 


The compressed image of the card in ASCII. One or more spaces are replaced in the image as follows: 


1 space replaced by 040g 

2 spaces replaced by 001 g 

3 spaces replaced by 002g 

4 spaces replaced by 003g 


31 spaces replaced by 036g 

32 spaces replaced by 037g 040g 

33 spaces replaced by 037g 041g 

OOOg(NUL) replaced by 037g OOOg 
OOIg(SH) replaced by 037g 001g 


037g(US) replaced by 037g 037g 

Compressed ASCII characters are stored as I'A 8-bit characters per 60-bit word, with multiple blanks 
compressed and trailing blanks removed. A four-digit octal code OOOOg marks the end of the card, if 
the code occurs before the end of the last word is reached. Only the lower 8 bits of each 12-bit byte 
are saved; the upper 4 bits are ignored, unless expanding a compressed card image. When expanding an 
ASCII compressed card image, the upper 4 bits of each character are set to zero, unless the character is 
NUL (OOOg). If the character is NUL, the 12-bit value 4000g is returned. Characters in the range 
041g to 3/7g are stored unchanged. 


Figure D-10. Compressed Text Format on Program Library (Sheet 2 of 2) 
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When the data field is 72 and the card image is 80 columns, 
8 columns are available for sequencing information. If the 
data field is 80 and the card image is 90, 10 columns are 
available for sequencing information. In either of these 
cases, if the identifier and sequence number exceed the 
field, Update truncates the least significant (right-most) 
characters of the identifier leaving the sequence number 
intact. 


If the data field and card image are both 80, the compile 
file output cannot have sequence Information appended. 

The example in figure D-12 shows how Update positions 
sequencing information for the various control statement 
options. 

The width statement overrides the values specified by D 
and 8. The table D-5 shows the equivalence of the D and 8 
parameter options to the *WIDTH directive. 


TABLE D-3. WIDTH DIRECTIVE EQUIVALENCE 
TO D AND 8 OPTIONS 


D and 8 Options 

♦WIDTH Equivalent 

neither D nor 8 option 

♦WIDTH 72,14 

D option 

♦WIDTH 80,10 

8 option 

♦WIDTH 72,8 

D,8 option 

♦WIDTH 80,0 


If the 80- or 90-character card image on the compile file 
has two blanks as the last two characters, these are 
converted to a 0000 line terminator and the card image is 8 
(or 9) words long. If the last two columns do not contain 
blanks, a word containing 8 blanks and a zero-byte line 
terminator are added, thus making the card image 9 (or 10) 
words lonq. This same procedure is used for creation of the 
source file. 

The format of the compressed compile file is shown in 
figure D-13. The first word is a loader prefix table (77 q). 
Compressed format is generated through the X option on 
the UPDATE control statement. 



73 

1 74 1 






80 

■ 

■ 

■ 

■ 

■ 

86 

■ 

in 

■ 

90 


E9 

B 

E 

B 

E 

B 

B 

B 

LJ 


1 

Llj 

4 

4 



n 


- 

r_ 

n 




n 


□ 

B 

B 

□ 

B 

ra 

B 

1 

I 

B 

B 


B 

B 

B 

B 

1 

b 

B 

B 

n 

□ 

□ 

□ 

□ 

□ 



□ 

□ 


I-WITH 8 OPTION 

-WITH D OPTION 

-NORMAL COMPILE OUTPUT 


Figure D-12. Sequencing Format for Compile File 
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59 53 47 41 35 


77 00 00 00 


sequence field 1 


compressed card 1 


sequence field 2- 


compressed card 2 


compressed cards can use more than one word 


sequence field n 


^_ compressed card n ___j 

sequence fieldj 17 characters comprising card columns 74 through 90. Column 73 is always blank. 

nwj Binary number of words in compressed cardj. 

compressed card; Each 00 character is replaced by the 12-bit value 0001, and three or more consecutive blanks 
(to a maximum of 64) are replaced by a 12-bit value 0002 through 0077o. A single blank is 
represented in display code (55g); two consecutive blanks are represented by the 12-bit value 5555g. If 
the last word is not full, it is padded on the right with binary zeros. Because word count nw is 
present, an extra all-zero word is not required to guarantee 12 zero bits. "WIDTH directives are ignored 
with compressed compile files. The full card image is always present, and the sequence field information 
is always a full 17 characters. 


Figure D-13. Compile File Compressed Format 
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A parameter 4-1 
ABBREV directive 3-12 
ADDFILE directive 

Description 3-2, 3-5 
Examples 5-4 


B parameter 4-1 
BEFORE directive 3-6 


C parameter 4-1 
CALL directive 

Description 3-10 
Example 5-2 
Card identifier 1-1, 3-1 
CHANGE directive 3-6 
COMDECK directive 
Description 1-2, 3-4 
Example 5-1 
Comments 3-1, 3-15, 4-6 
Common decks (see Decks) 

COMPILE directive 3-11 
Compile file (see Files) 

Control Statement (see UPDATE control statement) 
COPY directive 

Description 3-6 
Example 5-2 
Correction run 

Description 1-2 
Example 5-2 
Files 2-1 

Correction set 1-2, 3-7 
Correction history bytes 1-2 
Copy run 1-3, 2-1 
Creation run 

Description 1-2 
Example 5-1 
Flies 2-1 

CWEOR directive 3-1, 3-2, 3-11 


D parameter 4-1 
Debugging 4-5 
DECK directive 

Description 1-2, 3-5 
Example 5-1 
Deck list 1-2, D-4 
Decks 

Common 

Description 1-2, 3-4 
Calling 3-10 
Example 5-1 
Regular 1-2, 3-4, 5-1 
DECLARE directive 3-1, 3-13 
DEFINE directive 
Description 3-13 
Example 5-3 
DELETE directive 
Description 3-7 
Example 5-2 
Directives 

Compile file 2-3, 3-10 
Correction 3-5 
Deck identifying 3-4 
Description 1-1, 3-1 


Directives (contd) 

File manipulation 3-13 
Input stream control 3-13 
Special 3-14 
Directory 1-2, 3-8, D-4 
DO directive 

Description 3-11 
Example 5-4 
DONT directive 

Description 3-11 
Example 5-4 


E parameter 4-1 
END directive 3-15 

ENDIF directive 

Description 3-11 
Example 5-4 
ENDTEXT directive 3-13 


F parameter 4-2 
Files 

Compile 

Control statement parameters 4-1, 4-5 
Description 1-1, 2-3 
Format D-6 
Input 

Description 1-1, 2-1 
Control statement parameter 4-3 
Example 5-1 
New program library 

Description 1-1, 2-3 
Control statement parameter 4-4 
Merge file 2-4, 4-4 
Old program library 

Description 1-1, 2-3 
Control statement parameter 4-4 
Output 

Description 1-1, 2-3 
Control statement parameter 4-3 
Pullmod 2-4, 4-2, 5-5 

Secondary old program library 2-3, 3-11, 4-4 
Source 1-1, 2-4, 4-5 
Full mode (see Update mode) 


G parameter 4-2 


H parameter 4-3 


I parameter 

Description 4-3 
Example 5-2 
IDENT directive 3-7 
IF directive 

Description 3-12 
Example 5-4 
Input file (see Files) 
Input stream 1-1, 2-2 
INSERT directive 
Description 3-7 
Example 5-2 
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K parameter 4-3 


L parameter 4-3 
LIMIT directive 3-13 
LIST directive 3-12 


M parameter 4-4 

Master control character 3-1, 4-5 

Merge file (see Files) 

MOVE directive 3-0 


N parameter 4-4 

New program library (see Files) 

NOABBREV directive 3-13 

NOLIST directive 3-13 

Normal selective mode (see Update mode) 


S parameter 4-5 

Secondary input stream (see Input stream) 
Secondary old program library (see Files) 
SELPURGE directive 

Description 3-9, 5-3 
SELYANK directive 
Description 3-9 
Example 5-3 
SEQUENCE directive 3-9 

Sequential program library (see Program library) 
SKIP directive 3-12 
Source file (see Files) 


T parameter 4-5 
TEXT directive 3-13 


O parameter 4-4 

Old program library (see Files) 

Output file (see Files) 


P parameter 4-4 

Primary input stream (see Input stream) 
Program library (see also Files) 

Auditing 4-3 
Editing 4-1 
Random and sequential 

Description 2-2, 4-1, 4-4 
F ormat D-l 
PULL MOD directive 
Description 3-14 
Example 5-5 
Pullmod file (see Files) 

PURDECK directive 
Description 3-0 
Example 5-3 
PURGE directive 

Description 3-0 
Example 5-3 


Q parameter 4-4 

Quick mode (see Update mode) 


R parameter 4-5 

Random program library (see Program library) 
READ directive 3-12 
Regular deck (see Decks) 

RESTORE directive 3-9 
R0WIND directive 3-13 


U parameter 4-5 
UPDATE control statement 
Description 4-1 
Parameters 1-1, 4-1 
Examples 4-6 
Update mode 

Full 1-3,4-2 

Normal selective 1-3, 4-2, 4-4 
Quick 1-3, 2-3, 4-4 


W parameter 4-5 
VCOR directive 

Description 3-1, 3-12 
Example 5-1 
WIDTH directive 

Description 3-12 


X parameter 4-5, D-9 


YANK directive 

Description 3-10 
Example 5-3 
YANKDECK directive 
Description 3-10 
Example 5-3 
YANK$$$ deck 1-2, D-4 


0 parameter 4-5 
/ comment directive 3-14 
/ parameter 4-6 
* parameter 4-5 
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